Configuração do Pinky Brain

O Pinky se configura com flags (CLI) e variáveis de ambiente (as três peças: CLI, MCP e hooks). Não há arquivo de config central: os defaults são sensatos e tudo o que é relevante pode ser definido por env ou flag.

Precedência no CLI: flag > env var > default. Ex.: --db x.db ganha de PINKY_DB, que ganha do default brain.db.

Variáveis de ambiente

Variable	Usada por	Default	O que faz
`PINKY_DB`	CLI · MCP · hooks	`brain.db`	Caminho do índice SQLite (derivado e descartável). Defina igual nas três peças para que CLI e agente vejam a mesma base. `pinky init` registra o MCP com `PINKY_DB=brain.db`, o mesmo default do CLI, assim `pinky reindex` e o agente compartilham o índice.
`PINKY_HASH_EMBED`	CLI · MCP	(sem definir)	Se estiver presente, usa o embedder determinístico (sem baixar o modelo ONNX). Útil offline/CI. No CLI equivale a `--hash-embed`.
`PINKY_SAVE_DIR`	MCP	`documentation`	Pasta onde `brain_save` grava os `.md` fonte da verdade.
`PINKY_PROJECT`	MCP	(global)	Se estiver definida, as entradas que o MCP salva ficam no scope `project:<valor>` (filtráveis por projeto).
`PINKY_DIARY_DIR`	hooks	(stdout)	Pasta onde o hook `stop` grava o diary (`YYYY-MM-DD.md`). Sem ela, a linha vai para stdout.
`PINKY_LOG` / `RUST_LOG`	todas	`warn`	Nível de logging (`error`/`warn`/`info`/`debug`/`trace`). Sempre vai para stderr (não contamina o stdout do MCP nem a saída de dados do CLI).

Flags globais do CLI

Flag	O que faz
`--db <caminho>`	Índice a usar (equiv. `PINKY_DB`).
`--hash-embed`	Embedder determinístico sem modelo (equiv. `PINKY_HASH_EMBED`).
`--json`	Saída em JSON, para scripting. Disponível em todos os comandos com saída para stdout. Em `search`, além disso desativa o registro de telemetria (uso programático).
`--version`	Versão do binário (`pinky`, `pinky-mcp` e `pinky-hooks` a reportam).

Diagnóstico

pinky doctor imprime a config efetiva do índice: versão do schema, quantidade de entradas/chunks, modelo com o qual foi indexado vs. o embedder ativo (avisa se não coincidem) e a versão do binário. Com --json é apto para monitoramento.

pinky --db brain.db doctor
pinky --db brain.db --json doctor

Autocompletar

pinky completions zsh  > ~/.zfunc/_pinky        # zsh
pinky completions bash > /etc/bash_completion.d/pinky
pinky completions fish > ~/.config/fish/completions/pinky.fish