Docs
Refer a friend. Get a weekly-quota reset.Friend signs up and uses it → +1 reset (valid 30 days) · up to 10% cash back on their spend.
+1 resetGenerate link

CLI reference

Command families, shared options and input constraints in the current developer version.

Commands

Prefix every command below with openmybot.

CommandPurpose
init --pg-bin-dir PATHInitialize with PostgreSQL 17 binaries
daemonRun in the foreground
status [--run RUN_ID]Overview or one run
pair CHANNEL --workspace PATH [--run-deadline SECONDS]Pair a channel
bindings listList bindings
bindings revoke IDRevoke access
bindings reconfirm IDReconfirm a binding
bindings reset-thread ID --ack-unknown RUN_IDReset after acknowledging an unknown run
bindings receiver CHANNELRead declared credential fields from stdin
bindings host crabcode --workspace PATH [--run-deadline SECONDS]Bind the supported host
approve ID / deny IDOwner permission decisions
cancel RUN_IDRequest cancellation
plugins listList installed plugins
plugins add PATHInstall a local plugin directory
plugins add --built-in telegram / feishuInstall a bundled channel plugin
plugins remove NAMERemove a plugin
mcpStart 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.