CLI › MUXI Documentation

Manage formations from the command line

The muxi CLI handles everything: creating formations, managing secrets, deploying to servers, and chatting with your agents.

Installation

brew install muxi-ai/tap/muxi

curl -fsSL https://muxi.org/install | sudo bash

powershell -c "irm https://muxi.org/install | iex"

Verify:

muxi --version

Command Overview

Create

muxi new formation <name>
muxi new agent <name>
muxi new mcp <name>

Develop

muxi up
muxi down
muxi validate
muxi chat

Secrets

muxi secrets setup
muxi secrets set <key>
muxi secrets list

Deploy

muxi deploy
muxi server list
muxi server restart <id>

Registry

muxi pull @muxi/hello-muxi
muxi push
muxi search <query>

Monitor

muxi logs <formation>
muxi server get <id>

Common Workflows

Create and Run Locally

muxi new formation my-assistant
cd my-assistant
muxi secrets setup
muxi up              # Like docker compose up
# ... develop ...
muxi down            # Like docker compose down

Deploy to Server

muxi deploy --profile production
muxi server list
muxi logs my-assistant --follow

Pull from Registry

muxi pull @acme/research-agent
cd research-agent
muxi secrets setup
muxi up

Quick Reference

Command	Description
`muxi new`	Create formations, agents, MCPs, SOPs, triggers
`muxi up`	Start formation locally (like docker compose up)
`muxi down`	Stop local formation (like docker compose down)
`muxi deploy`	Deploy to server
`muxi server`	Manage deployed formations
`muxi secrets`	Manage encrypted secrets
`muxi logs`	View formation logs
`muxi chat`	Interactive chat with formation
`muxi pull`	Download from registry
`muxi push`	Publish to registry
`muxi profiles`	Manage server profiles
`muxi validate`	Validate formation config

Configuration

CLI config: ~/.muxi/cli/config.yaml

default_profile: local
editor: vim
output:
  format: table    # table, json

Command Reference

muxi new

Create formations, agents, MCPs, triggers, SOPs.

muxi up/down

Local development - like docker compose.

muxi deploy

Deploy formations to servers.

muxi secrets

Manage encrypted secrets.

muxi server

Manage deployed formations.

muxi pull/push

Pull and publish formations.

muxi chat

Interactive chat sessions.