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

Management¶

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

Remote Access¶

By default, mb connects to http://localhost:9100. Configure remote access:

# In ~/.metabot/.env or ~/metabot/.env
METABOT_URL=http://your-server:9100
API_SECRET=your-secret