Configuration
| Setting | Where | Effect |
|---|---|---|
trackbed.baseBranch |
git config --local, per repository |
The workbench branch new work starts from, when it differs from the remote default. --base <branch> overrides it for one run. See Base Branch. |
TRACKBED_REVIEW_SUBAGENT_LEVEL |
The env block of Claude Code's settings.json, or the shell environment Codex inherits |
same (default) keeps review subagents on the orchestrator's model; lower steps them down one model class. See Reviewer Models. |
--subagent-model <model> |
Flag on review skills and codebase audits | Picks the reviewer model for one run and wins over TRACKBED_REVIEW_SUBAGENT_LEVEL. |
| Hook toggles | /trackbed:hooks:toggle |
Enable, disable, or reset hooks. State lives in ${XDG_STATE_HOME:-$HOME/.local/state}/trackbed/hook-state.json unless TRACKBED_HOOK_STATE_FILE points elsewhere. See Toggling Hooks. |
TRACKBED_AUTOFORMAT_DEBUG=1 |
Environment | Keeps the latest failed auto-format attempt's stderr in a private local file. Off by default. See Failure Diagnostics. |
CODEX_HOME |
Environment | A non-default Codex home. Keep it exported in shells Codex runs. |
.context/ in .gitignore |
Your repository | Required to resume interrupted GitHub reviews and codebase audits, which save their progress there. |
Auto Mode
Section titled “Auto Mode”Instead of maintaining a static permission allowlist, use the host's built-in auto mode to reduce approval prompts while retaining its automatic safety checks:
- Claude Code — start a session with
claude --permission-mode auto - Codex — start a session with
codex --approve-for-me
Enable auto mode only in repositories you trust, and review changes before publishing them.