mb CLI (Agent Bus)¶

The mb command provides terminal access to the MetaBot Agent Bus API.

Installation¶

Installed automatically by the MetaBot installer to ~/.local/bin/mb.

Commands¶

Bot Management¶

mb bots                             # list all bots (local + peer)
mb bot <name>                       # get bot details

Agent Talk¶

mb talk <bot> <chatId> <prompt>     # talk to a bot
mb talk alice/bot <chatId> <prompt> # talk to a specific peer's bot

The bot name supports qualified names (peerName/botName) for cross-instance routing.

Peers¶

mb peers                            # list peers and status

Scheduling¶

mb schedule list                                              # list all tasks
mb schedule cron <bot> <chatId> '<cron>' <prompt>            # create recurring task
mb schedule add <bot> <chatId> <delayMs> <prompt>            # create one-time task
mb schedule pause <id>                                        # pause a task
mb schedule resume <id>                                       # resume a task
mb schedule cancel <id>                                       # cancel a task

Stats & Health¶

mb stats                            # cost & usage statistics
mb health                           # health check

Voice¶

mb voice "Hello world"              # generate MP3, print file path
mb voice "Hello" --play             # generate and play audio
mb voice "Hello" -o greeting.mp3    # save to specific file
echo "Long text" | mb voice         # read from stdin
mb voice "Hello" --provider doubao  # use specific TTS provider
mb voice "Hello" --voice nova       # use specific voice

Flag	Description
`--play`	Play audio after generating (macOS: afplay, Linux: mpv/ffplay/play)
`-o FILE`	Save to specific file (default: `/tmp/mb-voice-<timestamp>.mp3`)
`--provider NAME`	TTS provider: `doubao`, `openai`, or `elevenlabs`
`--voice ID`	Voice/speaker ID (provider-specific)

Management¶

mb update                           # pull + rebuild + restart
mb help                             # show help

Remote Access¶

By default, mb connects to http://localhost:9100. For internet-reachable deployments, point it at your HTTPS reverse proxy. If you use a private network such as Tailscale or WireGuard, you can use that private address instead.

# Generate a secret once: openssl rand -hex 32
# In ~/.metabot/.env or ~/metabot/.env
METABOT_URL=http://your-server:9100
API_SECRET=your-secret