Schaltwerk’s workflow revolves around sessions (isolated git worktrees), reusable specs, and the orchestrator that coordinates everything. Use this overview to jump into the detailed guides.Documentation Index
Fetch the complete documentation index at: https://schaltwerk.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Start Here
Sessions & Specs
Understand how specs become sessions, how state transitions work, and how to recycle or archive work.
Worktrees & Terminals
Learn how PTY terminals behave, how to run commands, and how to keep worktrees tidy.
Glossary
Claude Code
CLI interface from Anthropic that runs in Schaltwerk’s orchestrator terminal. When you start a Claude Code session, the top terminal launches the
claude CLI.GitHub Copilot
GitHub’s Copilot CLI runs directly in the session terminal. Install it with
npm install -g @github/copilot, trust the worktree once via /cwd /trust, and Schaltwerk auto-sends your first prompt when the CLI finishes booting.Codex
Git-based AI agent from Stately used for repository automation. Configurable via Settings → Agent Configuration.
OpenCode
Open-source terminal agent. Behaves similarly to Claude Code but uses the
opencode CLI.Gemini
Google’s Gemini CLI integration for code generation and refactors. Launches in the session terminal via the
gcloud toolchain.Kilo Code
CLI for Kilo Code that allows planning, debugging, and coding from the terminal with various modes.
Factory Droid
Automation-focused agent that executes scripts and CI tasks. Managed via the same session workflow.