Configuración
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.tomlen el directorio actual — anulación por invocación..boost/config.tomlen la raíz del repo git que lo contiene.~/.boost/config.tomlen tu home — respaldo global que escribeboost 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/
- WSL — same as Linux, ~/.local/share/boost/ inside the distro
- 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
telemetry = false # no OTEL spans, no remote export, no Unleash network
upload = false # skip remote OTLP upload (ignored when telemetry = false)
[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. | true |
| [tracing] telemetry | Pon false para desactivar recolección OpenTelemetry, export remoto (incl. OTEL_*) y red Unleash. boost init --no-telemetry lo escribe. history.db local no cambia. | 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 salvo telemetry = false; 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 |
Desactivar la telemetría por completo
boost init --no-telemetry escribe [tracing] telemetry = false. [tracing] upload = false solo evita que boost sync suba spans a JFrog (y cualquier espejo external_endpoint). Los spans pueden seguir guardándose en local y Unleash puede seguir usándose para feature flags. Para apagar toda la telemetría de producto — sin recolección OpenTelemetry, sin export remoto (incluidos overrides OTEL_*) y sin red Unleash — pon [tracing] telemetry = false en ~/.boost/config.toml global (el .boost/config.toml del proyecto gana si Boost lo lee primero).
~/.boost/config.toml
[tracing]
telemetry = false
Pon el mismo bloque [tracing] telemetry = false en .boost/config.toml del proyecto si solo quieres desactivarlo en un repo. El historial local en history.db no cambia; Boost sigue filtrando en tu máquina. Las líneas de ahorro en stderr son aparte — [tracing] report = false en el mismo archivo.
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_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. WSL usa XDG_DATA_HOME, como Linux. LOCALAPPDATA es Windows nativo. |
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 in config.toml |
| Desactivar solo la subida remota de telemetría | [tracing] upload = false |
| Desactivar toda la telemetría (sin spans, sin subida, sin Unleash) | boost init --no-telemetry, or [tracing] telemetry = false in ~/.boost/config.toml |
| Desactivar autoactualizaciones en segundo plano | [update] auto_update = false in ~/.boost/config.toml |
Relacionado
$ BOOST_REPORT_USD_PER_MTOK=9 boost report -w # one run; config.toml unchanged
$ BOOST_DB_PATH=/tmp/ci.db boost go test ./...