$ reference

Configuración

Boost funciona sin configuración — cada ajuste es opcional. Cuando quieras cambiar algo, vive en un único config.toml: por repo en .boost/config.toml, o globalmente en ~/.boost/config.toml.

Dónde busca Boost la configuración

Boost lee el primer config.toml que encuentra, en este orden:

.boost/config.toml en el directorio actual — anulación por invocación.
.boost/config.toml en la raíz del repo git que lo contiene.
~/.boost/config.toml en tu home — respaldo global que escribe boost init.

Un boost.config.toml heredado sigue leyéndose, pero .boost/config.toml tiene prioridad.

Desde un subdirectorio de monorepo, Boost lee <repo-root>/.boost/config.toml.

Directorio de config vs. datos

La config (config.toml) vive bajo .boost/. Los datos de runtime — history.db, caché de actualizaciones y tee logs — viven en el directorio de datos del SO:

macOS — ~/Library/Application Support/boost/
Linux — $XDG_DATA_HOME/boost/ or ~/.local/share/boost/
Windows — %LOCALAPPDATA%\boost\

Apunta la base de datos con BOOST_DB_PATH o [tracking] database_path.

Omitir reescritura de hook para comandos concretos

Cuando Cursor, Claude Code o Codex CLI ejecutan un comando, el hook de Boost reescribe herramientas compatibles a boost <cmd>. Para dejar comandos sin envolver, añádelos a [hooks] exclude_commands.

.boost/config.toml

[hooks]
exclude_commands = ["playwright", "vim", "docker"]

Con el ejemplo, playwright test sigue siendo playwright test.

Solo reescritura de hook

exclude_commands evita el envoltorio automático en hooks. No desactiva la captura si alguien ejecuta boost playwright test directamente.

Todos los ajustes

Cada clave es opcional. Las claves de nivel superior las escribe boost init al aceptar términos.

~/.boost/config.toml — global defaults

accept_terms = "yes"

[hooks]
exclude_commands = ["vim", "nano"]

[tracing]
report = false                 # silence per-command stderr savings lines
upload = false                 # skip remote OTLP upload (local spans still recorded)

[report]
usd_per_million_tokens = 5.0
co2e_kg_per_million_tokens = 0.21

[filters]
disabled = []                  # filter names skipped by the engine; retrieve auto-appends
retrieve_disable_threshold = 3 # retrieves per capability_id before auto-disable; 0 = never

[mcp]
toon_format = false            # opt in to MCP JSON→TOON (also needs Unleash boost-mcp-toon-format)

[update]
auto_update = false            # only read from ~/.boost/config.toml

El .boost/config.toml del proyecto solo define lo que difiere de los defaults globales:

.boost/config.toml — project override

[tracking]
database_path = "/data/ci/history.db"   # this repo's CI containers only

[report]
co2e_kg_per_million_tokens = 0.09       # this team's low-carbon region

Aquí accept_terms, [hooks] y [tracing] report quedan sin definir y heredan del global.

Clave	Propósito	Predeterminado
accept_terms	Registra que aceptaste los términos; lo establece `boost init`.	unset
[hooks] exclude_commands	Nombres de comando omitidos por el hook (coinciden con el binario de la primera palabra).	[ ]
[tracing] report	Pon `false` para ocultar el ahorro por comando en stderr. `BOOST_REPORT` lo anula.	true
[tracing] upload	Pon `false` para omitir la subida OTLP remota de `boost sync` (endpoint empaquetado y espejo externo). Los spans siguen guardándose en local; el JSONL de `--file` sigue escribiéndose.	true
[tracking] database_path	Ruta de la base SQLite de historial. `BOOST_DB_PATH` gana.	OS data dir / history.db
[report] usd_per_million_tokens	USD por 1M tokens ahorrados en `boost report` (no negativo).	5.0
[report] co2e_kg_per_million_tokens	kg CO2e evitados por 1M tokens ahorrados (no negativo).	0.21
[filters] disabled	Nombres de filtros TOML omitidos. `boost retrieve` añade nombres revertidos tras el umbral.	[]
[filters] retrieve_disable_threshold	Cuántos retrieve del mismo `capability_id` desactivan el filtro. `0` = nunca.	3
[update] auto_update	Pon `false` para desactivar autoactualizaciones. Solo config global.	true

Anulaciones por entorno

Las variables de entorno tienen prioridad sobre config.toml.

Variable	Efecto
BOOST_DB_PATH	Ruta de la base SQLite; anula `[tracking] database_path`.
BOOST_REPORT	`0` silencia el ahorro por comando en stderr.
BOOST_REPORT_USD_PER_MTOK	Anula `[report] usd_per_million_tokens`.
BOOST_REPORT_CO2E_KG_PER_MTOK	Anula `[report] co2e_kg_per_million_tokens`.
BOOST_TEE_DIR	Directorio de tee logs de salida cruda en fallos.
XDG_DATA_HOME / LOCALAPPDATA	Reubica el directorio de datos en Linux / Windows.

Resumen

Objetivo	Mecanismo
Editar ajustes de un proyecto	.boost/config.toml
Editar ajustes para todos los proyectos	~/.boost/config.toml
El agente no debe envolver `playwright`, `vim`, etc.	[hooks] exclude_commands
Mover la base de historial	BOOST_DB_PATH or [tracking] database_path
Ocultar ahorro por comando en stderr	[tracing] report = false or BOOST_REPORT=0
Desactivar la subida remota de telemetría	[tracing] upload = false
Desactivar autoactualizaciones en segundo plano	[update] auto_update = false in ~/.boost/config.toml

Relacionado

Filtros TOML

Añade reglas de compresión para herramientas sin filtro integrado.

Ahorro de tokens

Cuánto comprime Boost antes de que llegue al agente.

$ BOOST_REPORT_USD_PER_MTOK=9 boost report -w       # one run; config.toml unchanged
$ BOOST_DB_PATH=/tmp/ci.db boost go test ./...
$ BOOST_REPORT=0 boost npm test