Variáveis de ambiente e arquivos
Onde mora cada coisa: a precedência de config, as variáveis de ambiente que o Okami lê e o que aparece no diretório .okami/ quando você usa o agente.
Precedência de configuração
| arquivo | papel · versionado? |
|---|---|
| okami.yaml | config base (providers, memória, contratos) · ✅ sim |
| okami.local.yaml | overrides locais (deep-merge sobre o base; vence) · ❌ não |
| .env | segredos do PROJETO · ❌ não |
| ~/.okami/.env | segredos GLOBAIS (qualquer workspace, 0600) · ❌ não |
| okami.policy.yaml | postura de conformance autorada · ✅ sim |
Segredos têm precedência: ambiente real > .env do projeto > .env global. O okami config set <CHAVE_MAIÚSCULA> grava no .env global por padrão (--project usa o do projeto).
Variáveis de ambiente
params OKAMI_API_TOKEN segredo Bearer da API HTTP (okami serve) — fail-closed, sem ele a API não sobe. MIMO_API_KEY segredo Chave do provider MiMo (único por API key na postura padrão). <PROVIDER>_API_KEY segredo Referenciado por api_key_env (ex.: GITHUB_TOKEN num header de MCP). PAPERCLIP_API_URL / _API_KEY segredo Conexão com o Paperclip — injetadas por-run no heartbeat; não preencha à mão. PAPERCLIP_RUN_ID / _AGENT_ID / … string Metadata do run do Paperclip (referência/testes). EDITOR string Editor usado por okami config edit (senão nano/notepad).
O diretório .okami/ (por workspace/agente)
| caminho | o que é |
|---|---|
| events.jsonl | timeline append-only do turno (redigida, com trace_id) |
| audit.jsonl | toda tool + decisão de aprovação |
| sessions/<chat>.jsonl | transcript append-only (1 linha por turno) |
| checkpoints/journal.jsonl | journal de escritas (lock + HMAC) p/ rollback |
| memory.db | memória sqlite-fts5 (+ vetores) |
| taste.json | atratores/repulsores do gosto de design |
| persona_signals.json | sinais observados p/ evoluir VOICE/PERSONA |
| tuning.json | stats por modelo (auto-tune do capability) |
| quarantine/ | skills baixadas aguardando scan |
| gateway.pid · gateway.log | PID e log do gateway em background |
| cron.json | jobs agendados |
| chat_history | histórico de linha do REPL |