CLI reference
Command families, shared options and input constraints in the current developer version.
Commands
Prefix every command below with openmybot.
| Command | Purpose |
|---|---|
init --pg-bin-dir PATH | Initialize with PostgreSQL 17 binaries |
daemon | Run in the foreground |
status [--run RUN_ID] | Overview or one run |
pair CHANNEL --workspace PATH [--run-deadline SECONDS] | Pair a channel |
bindings list | List bindings |
bindings revoke ID | Revoke access |
bindings reconfirm ID | Reconfirm a binding |
bindings reset-thread ID --ack-unknown RUN_ID | Reset after acknowledging an unknown run |
bindings receiver CHANNEL | Read declared credential fields from stdin |
bindings host crabcode --workspace PATH [--run-deadline SECONDS] | Bind the supported host |
approve ID / deny ID | Owner permission decisions |
cancel RUN_ID | Request cancellation |
plugins list | List installed plugins |
plugins add PATH | Install a local plugin directory |
plugins add --built-in telegram / feishu | Install a bundled channel plugin |
plugins remove NAME | Remove a plugin |
mcp | Start the stdio MCP server |
Paths must be absolute. Place subcommand options after its command words and do not pass unknown flags.
Shared options
All commands except mcp accept --data-dir PATH and --json. mcp accepts the directory option but not --json. Explicit directory selection overrides OPENMYBOT_DATA_DIR.
Argument errors return exit code 2. This CLI uses a closed command parser; do not assume another tool's --help, --version or flags are supported. Consult this reference and the README for your source revision.
Automation
Read JSON state and preserve run, binding and permission IDs. A returned command does not by itself prove delivery or background completion. Receiver credentials belong on standard input, not argv.