Quick Agent Shifting

A VS Code-first handoff manager for switching work between AI roles and models such as Sol review, Terra implementation, Fable final review, Claude Sonnet implementation, Claude Opus deep reasoning, and Codex local execution.

Current Shape

The repo now has two layers:

• shift.cmd / scripts/shift.ps1: a simple command-line prompt generator.
• VS Code extension scaffold: a workspace-aware layer that generates handoffs, copies prompts, and writes session heartbeat files for a future detached hub.

VS Code Extension v0

Open this folder in VS Code, run npm install, then press F5 with the Run Extension launch config.

Commands:

Quick Shift: Pick Role
Quick Shift: Sol Review
Quick Shift: Terra Implement
Quick Shift: Fable Final Review
Quick Shift: Opus Plan
Quick Shift: Codex Implement
Quick Shift: Open Current Task
Quick Shift: Open Sessions Folder

Keyboard shortcuts:

Ctrl+Alt+S -> Pick role
Ctrl+Alt+R -> Sol review
Ctrl+Alt+T -> Terra implement

Each generated handoff is copied to the clipboard and saved in the active workspace:

.shift/current-task.json
.shift/handoffs/<timestamp>-<role>-<mode>.md

Each running VS Code workspace also reports a heartbeat here:

state/sessions/<session-id>.json

Those session files are the bridge for the future detached Shift Hub that can list all running VS Code windows.

CLI Quick Start

From this folder, use the short wrapper:

.\shift sol review "Review the current implementation for bugs and missing tests."
.\shift terra implement "Implement the fixes from the latest Sol handoff."
.\shift fable review "Final review the work for clarity and ship readiness."

Or call the PowerShell helper directly:

.\scripts\shift.ps1 sol review "Review the current implementation for bugs and missing tests."

Generated handoff prompts are local-only by default and ignored by Git.

Common Chains

Review, implement, review:

.\shift sol review "Review this task and produce actionable findings."
.\shift terra implement "Implement only the accepted findings from Sol."
.\shift sol review "Re-review Terra's changes and call out remaining blockers."

Claude complex task:

.\shift opus plan "Break down this complex task and identify the safest implementation path."
.\shift sonnet implement "Implement the Opus plan, keeping the change scoped."
.\shift fable review "Do the final review and prepare a handoff summary."

Files

• CLAUDE.md: shared instructions for all agent tools.
• AGENTS.md: Codex-style pointer to CLAUDE.md.
• agents/roster.json: role definitions and default behavior.
• src/extension.ts: VS Code extension entrypoint.
• scripts/shift.ps1: quick prompt generator.
• shift.cmd: short Windows wrapper for the helper.
• state/current-task.md: scratchpad for the CLI helper.
• state/sessions/: generated VS Code workspace session heartbeats.
• handoffs/: generated CLI prompts and handoff notes.