// referência · 07

Operar a memória

A memória tem API operacional própria. Você pode gravar fatos explícitos, buscar, listar, esquecer, arquivar, explicar e exportar. Isso é útil para auditar o que en…

Comandos

params memory add <texto> cmd grava um fato explicitamente; use --source, --kind, --global memory search <query> cmd busca por BM25/FTS5 + recência + importância; aceita --limit memory list cmd itens recentes; aceita --limit memory forget <id> cmd remove do retrieval sem apagar o histórico bruto memory archive <id> cmd arquiva um item; some do contexto mas fica auditável memory explain <id> cmd mostra categoria, origem, confiança e motivo memory consolidate cmd poda/consolida fatos conforme política do backend memory export cmd dump JSON para auditoria ou migração

Escopo global vs projeto

memory.global: true ativa uma camada global em ~/.okami combinada com a memória do projeto. Itens marcados como globais valem em qualquer workspace; fatos do projeto não contaminam outros projetos.

Política de persistência

Antes de persistir automaticamente, a política classifica o texto como fato, preferência, decisão, erro ou trivial. Trivial/efêmero é descartado. Segredos são detectados e bloqueados para não virar memória recuperável.

Saúde

okami doctor mostra backend ativo, FTS5, embedder online/offline e degradações. Se embeddings caírem, a interface continua funcionando em BM25.

Abrir esta página nos docs interativos