新しいリリースv0.17.5Nov 18, 2026

Boostの新しいバージョンをリリースしました— Clearer usage forecasts

設定

Boost はそのまま動作します — すべての設定は任意です。変更は config.toml に集約: リポジトリは .boost/config.toml、グローバルは ~/.boost/config.toml。

Boost が config を探す場所

Boost は次の順で 最初の config.toml を読みます:

  1. カレントディレクトリの .boost/config.toml。
  2. 囲む git リポジトリルート の .boost/config.toml。
  3. ホームの ~/.boost/config.toml — boost init が書くグローバル fallback。

レガシーの boost.config.toml も読みますが .boost/config.toml が優先されます。

モノレポのサブディレクトリからも <repo-root>/.boost/config.toml を読みます。

config ディレクトリとデータディレクトリ

config は .boost/ 配下。データ(history.db、キャッシュ、tee ログ)は 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\

BOOST_DB_PATH または [tracking] database_path で DB を移動。


特定コマンドのフック書き換えをスキップ

フックは対応ツールを boost <cmd> に書き換えます。[hooks] exclude_commands で除外できます。

.boost/config.toml

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

例では playwright test のままです。

フック書き換えのみ

exclude_commands は直接 boost playwright test を止めません。


すべての設定

すべてのキーは任意。boost init がトップレベルキーを書きます。

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

プロジェクトの .boost/config.toml は差分のみ:

.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

未設定キーはグローバルから継承。

キー目的デフォルト
accept_terms利用規約の承認を記録。boost init が設定。unset
[hooks] exclude_commandsフック書き換えをスキップするコマンド名(先頭語のバイナリ名で一致)。[ ]
[tracing] reportfalse で stderr の節約行を非表示。true
[tracing] telemetryfalse で OpenTelemetry 収集、リモート export(OTEL_* 含む)、Unleash ネットワークを無効化。boost init --no-telemetry がこれを書きます。ローカル history.db は変更なし。true
[tracing] uploadfalse で boost sync のリモート OTLP アップロードをスキップ(同梱エンドポイントと外部ミラー)。telemetry = false 以外はスパンはローカルに残り、--file JSONL は引き続き書き込まれます。true
[tracking] database_pathSQLite 履歴 DB の場所。BOOST_DB_PATH が優先。OS data dir / history.db
[report] usd_per_million_tokensboost report の 100 万節約トークンあたり USD。5.0
[report] co2e_kg_per_million_tokens100 万節約トークンあたり回避 kg CO2e。0.21
[filters] disabledスキップする TOML フィルター名。boost retrieve が閾値後にロールバック名を追加。[]
[filters] retrieve_disable_threshold同一 capability_id の retrieve 回数で自動無効化。0 = 無効化しない。3
[update] auto_updatefalse でバックグラウンド自己更新をオフ。グローバル config のみ。true

テレメトリを完全に無効化

boost init --no-telemetry は [tracing] telemetry = false を書き込みます。[tracing] upload = false は boost sync による JFrog(および external_endpoint ミラー)への span アップロードのみを止めます。span はローカルに記録され続け、Unleash は feature flag 用に呼ばれる場合があります。すべてのプロダクトテレメトリを止める — OpenTelemetry の span 収集なし、リモート export なし(OTEL_* 上書き含む)、Unleash ネットワークなし — には、グローバル ~/.boost/config.toml で [tracing] telemetry = false を設定します(Boost が先に読むプロジェクト .boost/config.toml が優先)。

~/.boost/config.toml

[tracing]
telemetry = false

1 リポジトリだけ無効にする場合は、プロジェクトの .boost/config.toml に同じ [tracing] telemetry = false を書きます。ローカルの history.db は変わりません。stderr の節約行は別設定 — 同じファイルで [tracing] report = false。


環境変数

環境変数は config.toml より優先されます。

変数効果
BOOST_DB_PATHSQLite 履歴 DB のパス。[tracking] database_path を上書き。
BOOST_REPORT_USD_PER_MTOK[report] usd_per_million_tokens を上書き。
BOOST_REPORT_CO2E_KG_PER_MTOK[report] co2e_kg_per_million_tokens を上書き。
BOOST_TEE_DIR失敗時の生出力 tee ログのディレクトリ。
XDG_DATA_HOME / LOCALAPPDATAデータディレクトリを移動。WSL は Linux と同様に XDG_DATA_HOME を使い、LOCALAPPDATA はネイティブ Windows。

まとめ

目的方法
プロジェクトの設定を編集.boost/config.toml
全プロジェクトの設定を編集~/.boost/config.toml
エージェントが playwright、vim 等をラップしない[hooks] exclude_commands
履歴 DB を移動BOOST_DB_PATH or [tracking] database_path
stderr の節約行を非表示[tracing] report = false in config.toml
リモートテレメトリのアップロードのみ無効化[tracing] upload = false
テレメトリを完全に無効化(span・upload・Unleash なし)boost init --no-telemetry, or [tracing] telemetry = false in ~/.boost/config.toml
バックグラウンド自己更新をオフ[update] auto_update = false in ~/.boost/config.toml

関連

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