The official command-line interface for creating, deploying, and managing MUXI AI agent formations.
Important
This repository is part of the MUXI ecosystem. See ARCHITECTURE.md for how all repositories fit together.
brew install muxi-ai/tap/muxi# macOS Apple Silicon
curl -L https://github.com/muxi-ai/cli/releases/latest/download/muxi-darwin-arm64 -o muxi
# macOS Intel
curl -L https://github.com/muxi-ai/cli/releases/latest/download/muxi-darwin-amd64 -o muxi
# Linux x86_64
curl -L https://github.com/muxi-ai/cli/releases/latest/download/muxi-linux-amd64 -o muxi
# Linux ARM64
curl -L https://github.com/muxi-ai/cli/releases/latest/download/muxi-linux-arm64 -o muxi
chmod +x muxi && sudo mv muxi /usr/local/bin/Download from GitHub Releases:
muxi-windows-amd64.exe(x86_64)muxi-windows-arm64.exe(ARM64)
# Create a new formation
muxi new formation my-bot
cd my-bot
# Configure secrets
muxi secrets setup
# Start locally (requires muxi-server running)
muxi up
# Chat with your formation
muxi chat "Hello!"
# Stop local formation
muxi down
# Deploy to server
muxi deploy --profile production- CLI Cheatsheet - Quick reference for all commands
- Getting Started - Installation and setup guide
- Full Documentation - Complete CLI documentation
- Formation Management - Create, deploy, and manage AI agent formations
- Local Development - Fast iteration with
muxi up/down(no deploy cycle) - Interactive Chat - TUI-based chat with streaming and markdown rendering
- Server Profiles - Multi-server support with HMAC authentication
- Registry Integration - Push/pull formations from the MUXI registry
- Shell Completions - Bash, Zsh, Fish, PowerShell
cd src
go build ./...
go test ./...See contributing/ for contributor documentation.
# Clone the repository
git clone https://github.com/muxi-ai/cli.git
cd cli/src
# Build for current platform
go build -o muxi .
# Cross-compile
GOOS=darwin GOARCH=arm64 go build -o muxi-darwin-arm64 .
GOOS=linux GOARCH=amd64 go build -o muxi-linux-amd64 .
GOOS=windows GOARCH=amd64 go build -o muxi-windows-amd64.exe .