תצורה
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/
- WSL — same as Linux, ~/.local/share/boost/ inside the distro
- 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
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; נקבע ע"י boost init. | unset |
| [hooks] exclude_commands | שמות פקודות שדולגות ב-hook rewrite (שם בינארי של המילה הראשונה). | [ ] |
| [tracing] report | false מסתיר שורת חיסכון ב-stderr. | true |
| [tracing] telemetry | false משבית איסוף OpenTelemetry, export מרוחק (כולל OTEL_*) ורשת Unleash. boost init --no-telemetry כותב זאת. history.db מקומי ללא שינוי. | true |
| [tracing] upload | false מדלג על העלאת OTLP מרחוק מ-boost sync (endpoint מובנה ומראה חיצוני). Spans נשארים מקומית אלא אם telemetry = false; 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 |
השבתת טלמטריה לחלוטין
boost init --no-telemetry כותב [tracing] telemetry = false. [tracing] upload = false עוצר רק העלאת spans על ידי boost sync ל-JFrog (וכל מראה external_endpoint). spans עדיין יכולים להישמר מקומית ו-Unleash עדיין יכול להיקרא ל-feature flags. כדי לכבות כל טלמטריית מוצר — בלי איסוף OpenTelemetry, בלי export מרוחק (כולל overrides של OTEL_*), בלי רשת Unleash — הגדירו [tracing] telemetry = false ב-~/.boost/config.toml הגלובלי (קובץ הפרויקט .boost/config.toml גובר אם Boost קורא אותו קודם).
~/.boost/config.toml
[tracing]
telemetry = false
לכיבוי בפרויקט בודד, הוסיפו את אותו בלוק [tracing] telemetry = false ב-.boost/config.toml של הפרויקט. היסטוריה מקומית ב-history.db לא משתנה. שורות חיסכון ב-stderr נפרדות — [tracing] report = false באותו קובץ.
משתני סביבה
משתני סביבה גוברים על config.toml.
| משתנה | השפעה |
|---|---|
| BOOST_DB_PATH | נתיב ל-DB SQLite; גובר על [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 logs של פלט גולמי בכשלון. |
| XDG_DATA_HOME / LOCALAPPDATA | מעביר את תיקיית הנתונים. WSL משתמש ב-XDG_DATA_HOME כמו Linux. LOCALAPPDATA הוא 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 in config.toml |
| השבתת העלאת טלמטריה מרחוק בלבד | [tracing] upload = false |
| השבתת כל הטלמטריה (בלי spans, בלי העלאה, בלי 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 ./...