Skip to content

Switchback 3.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 22 Oct 21:21
· 3 commits to main since this release
Immutable release. Only release title and notes can be modified.
v3.0.0
a7ed179

Added

  • Tab completes slash command arguments in the TUI. Models, agents, themes, effort levels, and each command's fixed words complete as you type. With several matches, Tab completes what they share, lists them, and goes round them. Inside a command, Tab no longer switches the model
  • Commands open a list when run with no argument. /agent, /subagent, /subagent-model, /effort, /theme, and /review let you pick the value, and /tab opens the sessions dashboard
  • Agents can tighten permissions. An agent's permissions (in its frontmatter or the agents config key) sets stricter category levels and adds ask and deny rules while it works. It never loosens yours (ADR 0029)

Changed

  • /review with no argument opens a list instead of going back to review.mode. Use /review default for that
  • Shift+Tab switches agents instead of permission modes. It goes build → plan → your own primary agents, and /agent <name> switches this session's agent while keeping the conversation instead of starting a new session. explore, review, and general only run as subagents (ADR 0029)
  • Plan mode is the plan agent. It can read, search, run commands after asking, and browse, but not edit. Approving its plan switches back to the agent before it; Approve and auto-approve also sets the auto level
  • Permission modes became three levels: ask, auto, and bypass. /permissions ask|auto|bypass switches them, and /mode is gone. permissions.level replaces permissions.defaultMode; the old value still loads, with plan starting the plan agent and acceptEdits becoming ask with a warning. --permission-mode takes the levels and the old names
  • Protocol 3. session.setPermissions and permissions.changed carry the level, and session.setAgent and agent.changed are new. session.setMode and mode.changed are gone (protocol.md)

Fixed

  • /model and the other pickers scroll past nine rows and wrap from the last row to the first and back
  • More read-only commands run without asking: tree, sort, uniq, nl, tr, readlink, od, the checksum tools, test, and others, unless a flag writes a file (sort -o). The tools' descriptions point the model at read, glob, and grep first
  • An input redirection from outside the workspace asks. cat < /etc/hosts counted as exploring the workspace

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-3.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.

Assets 19
Loading