Configuración de Pinky Brain

Pinky se configura con flags (CLI) y variables de entorno (las tres piezas: CLI, MCP y hooks). No hay archivo de config central: los defaults son sanos y todo lo relevante se puede fijar por env o flag.

Precedencia en el CLI: flag > env var > default. Ej.: --db x.db gana sobre PINKY_DB, que gana sobre el default brain.db.

Variables de entorno

Variable	Usada por	Default	Qué hace
`PINKY_DB`	CLI · MCP · hooks	`brain.db`	Ruta del índice SQLite (derivado y desechable). Fijala igual en las tres piezas para que CLI y agente vean la misma base. `pinky init` registra el MCP con `PINKY_DB=brain.db`, el mismo default del CLI, así `pinky reindex` y el agente comparten índice.
`PINKY_HASH_EMBED`	CLI · MCP	(sin setear)	Si está presente, usa el embedder determinista (sin descargar el modelo ONNX). Útil offline/CI. En el CLI equivale a `--hash-embed`.
`PINKY_SAVE_DIR`	MCP	`documentation`	Carpeta donde `brain_save` escribe los `.md` fuente de verdad.
`PINKY_PROJECT`	MCP	(global)	Si está seteada, las entradas que guarda el MCP quedan en el scope `project:<valor>` (filtrables por proyecto).
`PINKY_DIARY_DIR`	hooks	(stdout)	Carpeta donde el hook `stop` escribe el diary (`YYYY-MM-DD.md`). Sin ella, la línea va a stdout.
`PINKY_LOG` / `RUST_LOG`	todas	`warn`	Nivel de logging (`error`/`warn`/`info`/`debug`/`trace`). Siempre va a stderr (no contamina el stdout del MCP ni la salida de datos del CLI).

Flags globales del CLI

Flag	Qué hace
`--db <ruta>`	Índice a usar (equiv. `PINKY_DB`).
`--hash-embed`	Embedder determinista sin modelo (equiv. `PINKY_HASH_EMBED`).
`--json`	Salida en JSON, para scripting. Disponible en todos los comandos con salida a stdout. En `search`, además desactiva el registro de telemetría (uso programático).
`--version`	Versión del binario (`pinky`, `pinky-mcp` y `pinky-hooks` la reportan).

Diagnóstico

pinky doctor imprime la config efectiva del índice: versión de schema, cantidad de entradas/chunks, modelo con el que se indexó vs. el embedder activo (avisa si no coinciden) y la versión del binario. Con --json es apto para monitoreo.

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

Autocompletado

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