$ reference

設定

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

Boost が config を探す場所

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

カレントディレクトリの .boost/config.toml。
囲む git リポジトリルート の .boost/config.toml。
ホームの ~/.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/
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
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

プロジェクトの .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] report	`false` で stderr の節約行を非表示。`BOOST_REPORT` が優先。	true
[tracing] upload	`false` で `boost sync` のリモート OTLP アップロードをスキップ（同梱エンドポイントと外部ミラー）。スパンはローカルに残り、`--file` JSONL は引き続き書き込まれます。	true
[tracking] database_path	SQLite 履歴 DB の場所。`BOOST_DB_PATH` が優先。	OS data dir / history.db
[report] usd_per_million_tokens	`boost report` の 100 万節約トークンあたり USD。	5.0
[report] co2e_kg_per_million_tokens	100 万節約トークンあたり回避 kg CO2e。	0.21
[filters] disabled	スキップする TOML フィルター名。`boost retrieve` が閾値後にロールバック名を追加。	[]
[filters] retrieve_disable_threshold	同一 `capability_id` の retrieve 回数で自動無効化。`0` = 無効化しない。	3
[update] auto_update	`false` でバックグラウンド自己更新をオフ。グローバル config のみ。	true

環境変数

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

変数	効果
BOOST_DB_PATH	SQLite 履歴 DB のパス。`[tracking] database_path` を上書き。
BOOST_REPORT	`0` で stderr の節約行を抑制。
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	Linux / Windows でデータディレクトリを移動。

まとめ

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

Boostの新しいバージョンをリリースしました— Smarter savings and cleaner output

設定

Boost が config を探す場所

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

すべての設定

環境変数

まとめ

関連