agent-switch

One verb to migrate seamlessly between AI coding tools and models — no re-setup. switch claude drops you into Claude Code (Opus, subscription + connectors); switch flash runs aider on Gemini 3.5 Flash; switch opus runs aider on Opus for the money-path. It remembers your last pick, so a bare switch re-launches it.

switch claude    # Claude Code  — Opus, subscription + org connectors        → start
switch aider     # aider, cost-routed ladder                                 → agent
switch cursor    # Cursor editor (if installed)
switch flash     # aider · Gemini 3.5 Flash   (alias: gemini)                → fcode
switch pro       # aider · Gemini 3.1 Pro                                     → mcode
switch opus      # aider · Opus (API, money-path)                            → ocode
switch           # re-launch your last target

Install

npx @incultnitollc/agent-switch      # idempotent; safe to re-run
# then:
#   1) paste real keys into ~/.config/agent-keys.env
#   2) source ~/.zshrc

The installer: copies the shell lib to ~/.config/agent-switch.zsh, seeds ~/.config/agent-keys.env (chmod 600, placeholders — never clobbers real keys), source-guards it into your ~/.zshrc (skips if you already define these functions inline), and reports any missing prerequisites.

What you get

Command	Launches	Tool	Model	Billing
start	Claude Code, cwd-anchored to your repos root, same memory/CLAUDE.md/MCP/plugins	Claude Code	Opus	subscription + connectors
agent [-f|-a|-o] <repo> [task]	aider via a cost-router (Flash routine, Opus on money/auth/schema)	aider	Gemini / Opus	API
switch <target>	the right tool+model for target, remembers it	any of the above	—	—
fcode / mcode / ocode	aider on Fast / Mid / Smart pin directly	aider	Gemini / Opus	API

Configure

Models are pinned in one file, ~/.config/agent-keys.env — edit these, nothing else:

export FAST_MODEL="gemini/gemini-3.5-flash"       # switch flash
export MID_MODEL="gemini/gemini-3.1-pro-preview"  # switch pro
export SMART_MODEL="anthropic/claude-opus-4-8"    # switch opus

Point start / agent at a different repos root:

export AGENT_REPOS_ROOT="/path/to/your/repos"     # default: ~/incultnito/Dev/Backend/repos

Prerequisites

• aider (uv tool install aider-chat) — for agent, fcode/mcode/ocode, switch flash/pro/opus.
• Claude Code (npm i -g @anthropic-ai/claude-code) — for start, switch claude.
• Cursor (optional) — for switch cursor.
• A CONVENTIONS.md in each repo (aider --reads it). Seed one with newrepo-aider ..

Uninstall

Remove the # >>> agent-switch >>> block from ~/.zshrc and delete ~/.config/agent-switch.zsh. Your keys in agent-keys.env are left untouched.

Notes

• switch claude uses a claude() wrapper that unsets ANTHROPIC_API_KEY in a subshell, so Claude Code uses your subscription login + org connectors instead of metered API. Remove the wrapper if you prefer metered API billing.
• New terminal tab + switch claude again = a parallel agent with the same memory.