Arquivos de contexto como AGENTS.md e CLAUDE.md viraram o padrão para explicar a um Claude Code, Cursor ou Copilot como um projeto funciona. Quase ninguém os mantém atualizados, porque documentar o que você já sabe é a primeira tarefa a ser abandonada. Enquanto isso, o PiecesOS registra em silêncio as decisões, os bugs e os becos sem saída o dia inteiro. Este CLI move um para o outro.
Uma execução busca na sua memória via MCP com duas estratégias por categoria. A busca vetorial entende paráfrase, mas não enxerga o que foi indexado há poucos minutos; a full-text casa de forma estrita e imediata, mas perde o que foi escrito com outras palavras. Rodar as duas cobre a lacuna. Os resultados são filtrados para o repositório atual, passam por redação e viram markdown entre dois marcadores gerenciados, então o que você escreveu à mão sobrevive a toda execução.
Nada sai da sua máquina: toda chamada vai para localhost, sem conta e sem telemetria. E nada é escrito sem você ler antes. Cada execução imprime um diff e espera aprovação, e de propósito não existe flag para pular essa etapa.
Por baixo, ele lê a cadeia de resumos que o Pieces já escreve (uns 70 ms) em vez do endpoint ask_memory (uns 3,3 s de OCR bruto de tela), então as execuções são rápidas e a saída é markdown legível.