Every command, setting, CLI flag, and environment variable TokenBeaver understands — in the VS Code extension and in the standalone gateway.
Open the Command Palette with Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS) and type "TokenBeaver" to see all of these.
| Command ID | Palette title | What it does |
|---|---|---|
tokenbeaver.openSettings | TokenBeaver: Settings & Providers | Opens the settings/providers webview |
tokenbeaver.openFeedback | TokenBeaver: Feedback & Support | Opens the feedback page |
tokenbeaver.enterLicense | TokenBeaver: Activate or Upgrade to Pro | Paste an activation token, or activate via purchase email |
tokenbeaver.showStatusInfo | TokenBeaver: Show Status Info | Shows current license/gateway status |
tokenbeaver.copyShareSnippet | TokenBeaver: Copy Shareable Savings | Copies a shareable savings summary to the clipboard |
tokenbeaver.openDashboard | TokenBeaver: Open Cost Dashboard | Opens the cost/savings dashboard |
tokenbeaver.analytics.export | TokenBeaver: Export Analytics | Exports recorded analytics data |
tokenbeaver.analytics.reset | TokenBeaver: Reset Analytics | Clears recorded analytics |
tokenbeaver.gateway.start | TokenBeaver: Start Gateway | Starts the local proxy |
tokenbeaver.gateway.stop | TokenBeaver: Stop Gateway | Stops the local proxy |
tokenbeaver.gateway.copyBaseUrl | TokenBeaver: Copy Gateway Base URL | Copies the base URL for pointing agents at the gateway |
tokenbeaver.gateway.status | TokenBeaver: Gateway Status | Reports whether the gateway is running / on which port |
tokenbeaver.gateway.setup | TokenBeaver: Agent Setup Instructions | Shows how to point coding agents at the gateway |
tokenbeaver.claudeCode.repairHooks | TokenBeaver: Repair Claude Code Hooks | Re-installs TokenBeaver hooks into ~/.claude/settings.json |
tokenbeaver.openBillingPortal | TokenBeaver: Manage Subscription | Opens the Stripe Billing Portal (cancel/invoices/payment method) |
Set these in VS Code's Settings UI (search "tokenbeaver") or directly in settings.json.
| Setting | Default | What it does |
|---|---|---|
tokenbeaver.provider | openai | LLM provider for the engine/CLI (openai/anthropic/openrouter/custom/copilot) |
tokenbeaver.baseUrl | "" | Override API base URL for OpenAI-compatible providers |
tokenbeaver.model | gpt-4o-mini | Model for the engine/CLI |
tokenbeaver.timeout | 15000 | Engine/CLI API timeout (ms) |
tokenbeaver.analytics.retentionDays | 90 | Days of analytics kept for the dashboard (7–730) |
tokenbeaver.gateway.port | 4505 | Local gateway port |
tokenbeaver.gateway.provider | openrouter | Upstream provider for the gateway (built-ins + custom names) |
tokenbeaver.gateway.upstreamBaseUrl | "" | Upstream base URL override (required for custom endpoints) |
tokenbeaver.gateway.customProviders | [] | User-defined providers: { name, baseUrl }[] |
tokenbeaver.gateway.timeoutMs | 60000 | Gateway upstream timeout (ms) |
tokenbeaver.gateway.codeCompactionEnabled | true | Fold/compact code-like content in context; off = send code untouched |
tokenbeaver.gateway.readDedupEnabled | true | Replace repeated reads of unchanged files with a stub (needs gateway restart) |
tokenbeaver.gateway.routingEnabled | false | Opt-in model routing (upgrades only, never downgrades) |
tokenbeaver.gateway.tierModels | {} | Per-tier routing overrides: { cheap|balanced|premium: { provider, model } } |
tokenbeaver.gateway.autoStart | false | Start the gateway when VS Code opens |
tokenbeaver.claudeCode.installHooks | true | Auto-install Claude Code hooks on gateway start |
The standalone gateway runs outside VS Code too — same optimizer, driven from your terminal.
| Command | What it does |
|---|---|
tokenbeaver-gateway | Start the gateway server |
tokenbeaver-gateway --report | Print lifetime + per-session savings report |
tokenbeaver-gateway --reset-metrics | Reset all recorded metrics |
tokenbeaver-gateway --activate <token> | Activate a Pro license from a checkout token |
tokenbeaver-gateway --install-claude-hooks | Install hooks into ~/.claude/settings.json |
tokenbeaver-gateway --uninstall-claude-hooks | Remove those hooks |
tokenbeaver-gateway --help | Usage message |
Environment variables configure the standalone gateway process. When the gateway is started from the VS Code extension, the corresponding VS Code settings above take care of these for you.
| Env var | Default | What it does |
|---|---|---|
TOKENBEAVER_GATEWAY_PORT | 4505 | Listen port |
TOKENBEAVER_GATEWAY_PORT_STRATEGY | auto-detected | strict (fail if busy) · auto (scan for free port) · reuse (attach to existing gateway) |
TOKENBEAVER_PROVIDER | openrouter | Upstream provider (openai/anthropic/openrouter/copilot/custom) |
TOKENBEAVER_UPSTREAM_BASE_URL | — | Explicit upstream base URL (required for custom) |
TOKENBEAVER_TIMEOUT_MS | 60000 | Upstream request timeout |
TOKENBEAVER_CODE_COMPACTION_ENABLED | true | false disables code-folding compaction |
TOKENBEAVER_READ_DEDUP | on | off disables read deduplication |
TOKENBEAVER_TOOL_BUDGETS | Bash 200 / Grep 150 / Agent 200 / other 500 | Override per-tool line caps, e.g. bash:100,grep:50 (empty value = no cap) |
TOKENBEAVER_INSTALL_CLAUDE_HOOKS | on | off skips hook install on gateway start |
Email [email protected] or visit the support page — a real developer will get back to you.