Repository navigation
Switchback 2.0.0
Added
switchback usageis a dashboard in a terminal. Pick today, the last 7 days, the month, the year, or all time, step back through earlier periods with ← and →, and see spend, savings, budget meters, how tokens split between local and remote models, a chart per day or month, and the breakdown by rule, agent, or model.--from/--toreport any span of days,--periodalso takesyearandall, and piped output and--jsonwork as before. Theusage.getprotocol method takes arangeand returnsbyDay- Agents have modes, limits, and their own reasoning effort. An agent's
modesays whether it runs as a session's agent, as a subagent, or both;effortandmaxStepsset its reasoning effort and step limit; andagentslimits which subagents it may call (an empty list removes itstasktool). The newagentsconfig key adds agents, changes built-ins field by field, and turns them off withdisable: true.explorenow runs atloweffort - The parent picks a subagent's model and effort per task. The
tasktool takesmodelandeffort; an agent pinned to the local model refuses a remote one.subagents.effortsets the default for subagents whose agent sets none /effortchanges reasoning effort for the current session. It overrides the agent's and model's effort for that session only, and/effort defaultgoes back.--effortsets it at launch, it works the same in VS Code, and the protocol addssession.setEffort,effortonsession.create, and theeffort.changedevent- A Claude or ChatGPT plan brings all its models. Claude Code and Codex providers get every model their sign-in offers without listing them in config. Switchback asks the CLIs at launch (Codex through
codex app-server, Claude Code through the Agent SDK) and caches the answer insubscription-models.jsonin the data folder, so newly released models show up without an update or re-running setup. Setup no longer asks which Claude Code or Codex model to add;--remote-modelstill picks one - Setup asks for an API key for every provider that signs in with one (Anthropic, OpenAI, Azure OpenAI, DeepSeek, Gemini, Foundry, OpenCode, OpenRouter, and optionally OpenAI-compatible servers) when none is in the environment. The key is typed hidden, saved only in the user config, which setup makes readable by you alone, and never shown back. A project config never gets a key, and leaving the answer empty keeps reading the environment variable.
setup.askquestions carrysecret: truefor this
Fixed
- A permission prompt shows only in the client that owns the session. A terminal chat's prompt no longer pops up in VS Code, and the reverse
Removed
- No more Intel Mac build. Releases no longer include a
darwin-x64binary or.vsix. On an Intel Mac, the installer andswitchback self-updatenow say there is no build instead of failing to download one. Apple silicon under Rosetta still gets the arm64 build
Install
On macOS and Linux: curl -fsSL https://switchback.sh/install.sh | sh (add -s -- --vscode after sh for the VS Code extension too). On Windows, in PowerShell: irm https://switchback.sh/install.ps1 | iex. Or download the binary for your platform, verify it against SHA256SUMS, make it executable, and put it on your PATH as switchback. Then run switchback init.
Install the VS Code extension from the Marketplace or Open VSX (code --install-extension isaiah-harville.switchback), or from the switchback-vscode-2.0.0-<platform>.vsix here. Each platform's extension includes the engine, so no separate install is needed; the universal .vsix uses switchback from your PATH.
Binaries are not yet signed or notarized (#33). On macOS, clear the quarantine flag with xattr -d com.apple.quarantine switchback.