Nueva versiónv0.17.5Nov 18, 2026

Nueva versión de Boost disponible— Clearer usage forecasts

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:

  1. .boost/config.toml en el directorio actual — anulación por invocación.
  2. .boost/config.toml en la raíz del repo git que lo contiene.
  3. ~/.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/
  • 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.

ClavePropósitoPredeterminado
accept_termsRegistra que aceptaste los términos; lo establece boost init.unset
[hooks] exclude_commandsNombres de comando omitidos por el hook (coinciden con el binario de la primera palabra).[ ]
[tracing] reportPon false para ocultar el ahorro por comando en stderr.true
[tracing] telemetryPon 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] uploadPon 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_pathRuta de la base SQLite de historial. BOOST_DB_PATH gana.OS data dir / history.db
[report] usd_per_million_tokensUSD por 1M tokens ahorrados en boost report (no negativo).5.0
[report] co2e_kg_per_million_tokenskg CO2e evitados por 1M tokens ahorrados (no negativo).0.21
[filters] disabledNombres de filtros TOML omitidos. boost retrieve añade nombres revertidos tras el umbral.[]
[filters] retrieve_disable_thresholdCuántos retrieve del mismo capability_id desactivan el filtro. 0 = nunca.3
[update] auto_updatePon 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.

VariableEfecto
BOOST_DB_PATHRuta de la base SQLite; anula [tracking] database_path.
BOOST_REPORT_USD_PER_MTOKAnula [report] usd_per_million_tokens.
BOOST_REPORT_CO2E_KG_PER_MTOKAnula [report] co2e_kg_per_million_tokens.
BOOST_TEE_DIRDirectorio de tee logs de salida cruda en fallos.
XDG_DATA_HOME / LOCALAPPDATAReubica el directorio de datos. WSL usa XDG_DATA_HOME, como Linux. LOCALAPPDATA es Windows nativo.

Resumen

ObjetivoMecanismo
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 historialBOOST_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 ./...