Skip to main content
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.

​
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.
After reviewing the basics, check the Advanced Workflows guide to see how to orchestrate many agents in parallel.

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