Nouvelle versionv0.17.5Nov 18, 2026

Une nouvelle version de Boost est disponible— Clearer usage forecasts

Configuration

Boost fonctionne tel quel — chaque réglage est optionnel. Tout vit dans un seul config.toml : par dépôt dans .boost/config.toml, ou globalement dans ~/.boost/config.toml.

Où Boost cherche la config

Boost lit le premier config.toml trouvé, dans cet ordre :

  1. .boost/config.toml dans le répertoire courant.
  2. .boost/config.toml à la racine git du dépôt.
  3. ~/.boost/config.toml dans votre home — repli global écrit par boost init.

Un ancien boost.config.toml reste lu, mais .boost/config.toml prime.

Depuis un sous-dossier de monorepo, Boost lit <repo-root>/.boost/config.toml.

Répertoire config vs. données

La config vit sous .boost/. Les données runtime — history.db, cache et tee logs — vivent dans le répertoire de données OS :

  • 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\

Déplacez la base avec BOOST_DB_PATH ou [tracking] database_path.


Ignorer la réécriture de hook pour certains commandes

Les hooks Boost réécrivent les outils pris en charge en boost <cmd>. Ajoutez des noms à [hooks] exclude_commands pour les laisser nus.

.boost/config.toml

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

Avec l'exemple, playwright test reste inchangé.

Réécriture de hook uniquement

exclude_commands n'empêche pas la capture si on lance boost playwright test directement.


Tous les réglages

Chaque clé est optionnelle ; boost init écrit les clés de premier niveau.

~/.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

Le .boost/config.toml du projet ne définit que les différences :

.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

Ici, les clés non définies héritent du global.

CléRôleDéfaut
accept_termsEnregistre l'acceptation des conditions ; défini par boost init.unset
[hooks] exclude_commandsNoms de commandes ignorés par le hook (nom binaire du premier mot).[ ]
[tracing] reportMettez false pour masquer l'économie stderr.true
[tracing] telemetryMettez false pour désactiver la collecte OpenTelemetry, l'export distant (y compris OTEL_*) et le réseau Unleash. boost init --no-telemetry l'écrit. history.db local inchangé.true
[tracing] uploadMettez false pour ignorer l'upload OTLP distant de boost sync (endpoint intégré et miroir externe). Les spans restent locaux sauf si telemetry = false ; le JSONL --file est toujours écrit.true
[tracking] database_pathEmplacement de la base SQLite. BOOST_DB_PATH gagne.OS data dir / history.db
[report] usd_per_million_tokensUSD par 1M tokens économisés pour boost report.5.0
[report] co2e_kg_per_million_tokenskg CO2e évités par 1M tokens économisés.0.21
[filters] disabledFiltres TOML ignorés. boost retrieve ajoute les noms rollback après le seuil.[]
[filters] retrieve_disable_thresholdNombre de retrieve par capability_id avant auto-désactivation. 0 = jamais.3
[update] auto_updateMettez false pour refuser les mises à jour auto. Config globale uniquement.true

Désactiver toute la télémétrie

boost init --no-telemetry écrit [tracing] telemetry = false. [tracing] upload = false arrête seulement l'envoi des spans par boost sync vers JFrog (et tout miroir external_endpoint). Les spans peuvent encore être enregistrés localement et Unleash peut encore être contacté pour les feature flags. Pour couper toute la télémétrie produit — pas de collecte OpenTelemetry, pas d'export distant (y compris les overrides OTEL_*), pas de réseau Unleash — définissez [tracing] telemetry = false dans ~/.boost/config.toml global (le .boost/config.toml du projet prime si Boost le lit en premier).

~/.boost/config.toml

[tracing]
telemetry = false

Ajoutez le même bloc [tracing] telemetry = false dans le .boost/config.toml du projet pour limiter l'opt-out à un dépôt. L'historique local history.db est inchangé ; Boost filtre toujours en local. Les lignes d'économie stderr sont séparées — [tracing] report = false dans le même fichier.


Variables d'environnement

Les variables d'environnement priment sur config.toml.

VariableEffet
BOOST_DB_PATHChemin de la base SQLite ; prime sur [tracking] database_path.
BOOST_REPORT_USD_PER_MTOKRemplace [report] usd_per_million_tokens.
BOOST_REPORT_CO2E_KG_PER_MTOKRemplace [report] co2e_kg_per_million_tokens.
BOOST_TEE_DIRRépertoire des tee logs en cas d'échec.
XDG_DATA_HOME / LOCALAPPDATADéplace le répertoire de données. WSL utilise XDG_DATA_HOME, comme Linux. LOCALAPPDATA est Windows natif.

Résumé

ObjectifMécanisme
Modifier les réglages d'un projet.boost/config.toml
Modifier les réglages pour tous les projets~/.boost/config.toml
L'agent ne doit pas envelopper playwright, vim, etc.[hooks] exclude_commands
Déplacer la base d'historiqueBOOST_DB_PATH or [tracking] database_path
Masquer l'économie stderr par commande[tracing] report = false in config.toml
Désactiver uniquement l'upload de télémétrie distant[tracing] upload = false
Désactiver toute la télémétrie (pas de spans, pas d'upload, pas d'Unleash)boost init --no-telemetry, or [tracing] telemetry = false in ~/.boost/config.toml
Refuser les mises à jour en arrière-plan[update] auto_update = false in ~/.boost/config.toml

Voir aussi

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