CLI — agentes, skills, mídia e ops
O resto da superfície: multi-agente e canais, skills e MCP, identidade e memória, automação, mídia e os comandos de operação/observabilidade.
Agentes e canais
params agent new <id> cmd Cria agents/<id>/ (agent.yaml + identidade). Flags: --name, --provider, --memory, --match, --telegram-token. agent list cmd Lista os agentes e a config efetiva. route <origem> cmd Mostra p/ qual agente uma origem é roteada (ex.: telegram:123). gateway cmd Sobe os bots (1 por agente). Flags: -f/--foreground, --stop, --status. serve cmd API HTTP (POST /chat, Bearer). Flags: -p/--port (8765), --host (127.0.0.1). heartbeat cmd Uma batida do Paperclip. Flags: -a, -w, --mode (defer|yolo|off). paperclip cmd Checa a conexão com o Paperclip (env + GET /api/agents/me). acp cmd Servidor ACP (a IDE Zed/VS Code dirige o Okami via stdio). Flags: -a, -w.
Skills, gates e MCP
params skills cmd Lista as skills disponíveis (skills/*/SKILL.md). learn <fonte> cmd Baixa→quarentena→scan→instala. Flags: --force (instala apesar do risco), --allow-exec (fontes que executam código no fetch). scan <path> cmd Verifica risco de uma skill (exit 2 se bloqueada). gate <dir> cmd Roda o verification gate de design. Flag: -c/--contract (default ui). mcp cmd Lista os servidores MCP e as tools que expõem. tools cmd Lista as ferramentas do agente (categoria · tier · sensibilidade).
Identidade, gosto e memória
params persona-init cmd Cria stubs SOUL/VOICE/PERSONA. Flag: --name, -w. persona-evolve <feedback> cmd Evolui VOICE/PERSONA (go/no-go + changelog). Flags: --llm, --soul (permite editar o SOUL protegido), -y, -a, -w. persona-log / persona-rollback <n> cmd Histórico de evolução · reverte as últimas N. taste like|dislike|different <desc> cmd Ensina o gosto de design. Flag: --tags, -a, -w. taste show | steer cmd Mostra atratores/repulsores · imprime o steering injetado nos prompts. tune cmd Stats por modelo + recomendação de capability (auto-tune). memory add|search|list cmd Inspeciona/edita a memória do workspace (-w).
Automação
params cron add <schedule> <prompt> cmd Agenda: cron (5 campos) | intervalo ('1h') | ISO. Flags: -a (agente), --to (chat destino), -w. cron list | remove <id> | run <id> cmd Lista · remove · roda um job agora (ignora o schedule). cron tick cmd Roda os jobs VENCIDOS uma vez (use com o cron do sistema). hooks cmd Lista os event hooks configurados (okami.yaml hooks: ou hooks/<evento>/*.sh).
Mídia e voz
params image <prompt> cmd Gera imagem (gpt-image-2 via assinatura Codex). Flags: -o/--out, --ref (referência, repetível), --model, --size (1024x1024). say <texto> cmd TTS (Edge). Flags: -o/--out (okami_say.mp3), --voice. transcribe <áudio> cmd STT (Whisper local). Flag: --model (tiny|base|small). voice cmd Conversa por voz (turn-based). Flags: -a, --seconds (6), --whisper, --tts-voice, --once, -y.
Operação e observabilidade
params events cmd Timeline da última task (.okami/events.jsonl). Flags: -a, -w, -n (40). replay [trace] cmd Lista os turnos; com <trace>, reconstrói a trajetória completa. Flag: --json. rollback [n] cmd Desfaz as últimas N escritas de arquivo (checkpoints). 1 ps cmd Atalho para process list; lista processos em background do workspace/agente. Flags: -w, -a. process list|log|kill|signal|wait|clean cmd Supervisão externa de processos: logs, sinais, espera e poda TTL. Flags: -w, -a, -n, -f, -t, --ttl-hours, --dry-run. clean cmd Faxina de disco (lock órfão, temp, áudio e quota). Flags: --deep, --dry-run, --json, --lock-stale (300). version | help cmd Versão · visão geral agrupada dos comandos.