$ reference

תצורה

Boost עובד out of the box — כל הגדרה אופציונלית. השינויים ב-config.toml אחד: per repo ב-.boost/config.toml או גלובלי ב-~/.boost/config.toml.

איפה Boost מחפש config

Boost קורא את config.toml הראשון לפי הסדר:

.boost/config.toml בתיקייה הנוכחית.
.boost/config.toml בשורש ה-git repo.
~/.boost/config.toml ב-home — fallback גלובלי מ-boost init.

boost.config.toml ישן עדיין נקרא, אך .boost/config.toml גובר.

מתת-תיקייה במונורפו Boost קורא <repo-root>/.boost/config.toml.

תיקיית config מול data

config תחת .boost/. data — history.db, cache ו-tee logs — בתיקיית נתונים של OS:

macOS — ~/Library/Application Support/boost/
Linux — $XDG_DATA_HOME/boost/ or ~/.local/share/boost/
Windows — %LOCALAPPDATA%\boost\

העבירו DB עם BOOST_DB_PATH או [tracking] database_path.

דלגו על hook rewrite לפקודות מסוימות

hooks עוטפים כלים נתמכים ל-boost <cmd>. הוסיפו ל-[hooks] exclude_commands כדי להשאיר פקודות ללא עטיפה.

.boost/config.toml

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

בדוגמה playwright test נשאר כפי שהוא.

רק hook rewrite

exclude_commands לא מבטל capture ב-boost playwright test ישיר.

כל ההגדרות

כל מפתח אופציונלי; boost init כותב מפתחות top-level.

~/.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; נקבע ע"י `boost init`.	unset
[hooks] exclude_commands	שמות פקודות שדולגות ב-hook rewrite (שם בינארי של המילה הראשונה).	[ ]
[tracing] report	`false` מסתיר שורת חיסכון ב-stderr. `BOOST_REPORT` גובר.	true
[tracing] upload	`false` מדלג על העלאת OTLP מרחוק מ-`boost sync` (endpoint מובנה ומראה חיצוני). Spans נשארים מקומית; JSONL של `--file` עדיין נכתב.	true
[tracking] database_path	מיקום DB היסטוריה SQLite. `BOOST_DB_PATH` גובר.	OS data dir / history.db
[report] usd_per_million_tokens	דולר ל-1M טוקנים שנחסכו ב-`boost report`.	5.0
[report] co2e_kg_per_million_tokens	kg CO2e שנמנעו ל-1M טוקנים שנחסכו.	0.21
[filters] disabled	שמות מסנני TOML שמדולגים. `boost retrieve` מוסיף שמות rollback אחרי הסף.	[]
[filters] retrieve_disable_threshold	כמה retrieve לאותו `capability_id` מפעילים השבתה אוטומטית. `0` = לעולם לא.	3
[update] auto_update	`false` לביטול עדכונים ברקע. רק config גלובלי.	true

משתני סביבה

משתני סביבה גוברים על config.toml.

משתנה	השפעה
BOOST_DB_PATH	נתיב ל-DB SQLite; גובר על `[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 logs של פלט גולמי בכשלון.
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
הסתרת חיסכון per-command ב-stderr	[tracing] report = false or BOOST_REPORT=0
השבתת העלאת טלמטריה מרחוק	[tracing] upload = false
ביטול עדכונים עצמיים ברקע	[update] auto_update = false in ~/.boost/config.toml

קשור

מסנני TOML

כללי דחיסה לכלים בלי מסנן מובנה.

חיסכון בטוקנים

כמה Boost דוחס לפני שהפלט מגיע לסוכן.

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