CLI — agents, skills, media and ops
The rest of the surface: multi-agent and channels, skills and MCP, identity and memory, automation, media and the operations/observability commands.
Agents and channels
params agent new <id> cmd Creates agents/<id>/ (agent.yaml + identity). Flags: --name, --provider, --memory, --match, --telegram-token. agent list cmd Lists the agents and effective config. route <origin> cmd Shows which agent an origin routes to (e.g. telegram:123). gateway cmd Boots the bots (1 per agent). Flags: -f/--foreground, --stop, --status. serve cmd HTTP API (POST /chat, Bearer). Flags: -p/--port (8765), --host (127.0.0.1). heartbeat cmd One Paperclip beat. Flags: -a, -w, --mode (defer|yolo|off). paperclip cmd Checks the Paperclip connection (env + GET /api/agents/me). acp cmd ACP server (the IDE Zed/VS Code drives Okami over stdio). Flags: -a, -w.
Skills, gates and MCP
params skills cmd Lists available skills (skills/*/SKILL.md). learn <source> cmd Download→quarantine→scan→install. Flags: --force (install despite risk), --allow-exec (sources that run code on fetch). scan <path> cmd Check a skill's risk (exit 2 if blocked). gate <dir> cmd Run the design verification gate. Flag: -c/--contract (default ui). mcp cmd List MCP servers and the tools they expose. tools cmd List the agent's tools (category · tier · sensitivity).
Identity, taste and memory
params persona-init cmd Create SOUL/VOICE/PERSONA stubs. Flags: --name, -w. persona-evolve <feedback> cmd Evolve VOICE/PERSONA (go/no-go + changelog). Flags: --llm, --soul (allow editing the protected SOUL), -y, -a, -w. persona-log / persona-rollback <n> cmd Evolution history · revert the last N. taste like|dislike|different <desc> cmd Teach design taste. Flags: --tags, -a, -w. taste show | steer cmd Show attractors/repulsors · print the steering injected into UI prompts. tune cmd Per-model stats + capability recommendation (auto-tune). memory add|search|list cmd Inspect/edit the workspace memory (-w).
Automation
params cron add <schedule> <prompt> cmd Schedule: cron (5 fields) | interval ('1h') | ISO. Flags: -a (agent), --to (target chat), -w. cron list | remove <id> | run <id> cmd List · remove · run a job now (ignores the schedule). cron tick cmd Run DUE jobs once (use with the system cron). hooks cmd List configured event hooks (okami.yaml hooks: or hooks/<event>/*.sh).
Media and voice
params image <prompt> cmd Generate an image (gpt-image-2 via Codex subscription). Flags: -o/--out, --ref (reference, repeatable), --model, --size (1024x1024). say <text> cmd TTS (Edge). Flags: -o/--out (okami_say.mp3), --voice. transcribe <audio> cmd STT (local Whisper). Flag: --model (tiny|base|small). voice cmd Voice conversation (turn-based). Flags: -a, --seconds (6), --whisper, --tts-voice, --once, -y.
Operations and observability
params events cmd Timeline of the last task (.okami/events.jsonl). Flags: -a, -w, -n (40). replay [trace] cmd List turns; with <trace>, reconstruct the full trajectory. Flag: --json. rollback [n] cmd Undo the last N file writes (checkpoints). 1 ps cmd Shortcut for process list; lists background processes for a workspace or agent. Flags: -w, -a. process list|log|kill|signal|wait|clean cmd External process supervision: logs, signals, waiting and TTL pruning. Flags: -w, -a, -n, -f, -t, --ttl-hours, --dry-run. clean cmd Disk cleanup (stale lock, temp, audio and quota). Flags: --deep, --dry-run, --json, --lock-stale (300). version | help cmd Version · grouped command overview.