commands.json.
--json on persona, skill, inbox, and access-style list verbs when a program will parse stdout.
Auth and profiles
| Command | Notes |
|---|---|
auth set-token | Prompt, Keychain bot-token |
auth claim [--wait N] | Flush, wait for /claim, confirm |
auth set-owner <chat_id> | Positive private id |
auth status | Username, masked owner, daemon |
profile list | |
profile add <slug> | Prompt for that bot’s token |
profile set-token <slug> | Rotate |
profile enable|disable <slug> | |
profile rm <slug> [--delete-token --yes] | |
profile status [slug] |
Personas
| Command | Notes |
|---|---|
persona list [--json] | |
persona show <id-or-title> [--json] | |
persona add [--id] --title T [--display-name N] (--body | --file | --from-dir) | |
persona set <id> (--title | --display-name | --file) | |
persona apply <id> <profile> [profile…] | Next turn |
persona unapply <profile> [profile…] | |
persona rm <id> --yes | Not the builtin |
persona reset-builtin [id] | |
persona new-file <id> <rel> [--body] | |
persona rm-file <id> <rel> --yes | Refuses PERSONA.md |
Skills
| Command | Notes |
|---|---|
skill list [--json] | Global catalog |
skill show <id-or-name> [--json] | |
skill add (--file SKILL.md | --name N --body T) | Reserved ids refused |
skill set <id> (--file | --name | --description) | |
skill import PATH [--force] | Dir or zip, SKILL.md required |
skill rm <id> --yes | Not the builtin CRUD skill |
skill reset-builtin [id] | |
skill new-file / skill rm-file | Same shape as persona files |
Access, send, passcode
| Command | Notes |
|---|---|
access list [--profile P] | |
access add-user <id> [--label] [--node] [--thread] [--profile] | |
access grant <id> <node> [--thread] [--profile] | |
access revoke <id> <node> [--profile] | |
send [TEXT] [--file PATH]… [--as-document] [--profile] [--user|--owner] [--yes] | Dry-run without --yes |
passcode set / status / clear --yes | |
passcode relock-on-new|restart|node-switch|thread-switch [on|off] |
Daemon and config
| Command | Notes |
|---|---|
inbox [--json] | Debug poll |
daemon run / daemon status | |
install / restart / uninstall | |
ack set-key / ack set-model / ack status | OpenRouter |
config show / config timeout [--idle] [--max] | |
init-skill [--target] | Harness how-to, not bot packs |
self-update [--check|--force] | Compiled installs only |