<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> Schaltwerk provides native terminal integration for AI coding agents, enabling spec-driven development and parallel workflows. It targets developers seeking efficient, private, and isolated environments for coordinating multiple AI agents, offering a significant productivity boost over traditional command-line AI tool usage.

How It Works

The core approach leverages native terminal execution of agentic CLIs (e.g., GitHub Copilot CLI, Gemini) without wrappers, ensuring full feature access. Each agent session operates within an isolated Git worktree, preventing conflicts and enabling parallel development. Development is guided by Markdown specifications, which serve as reproducible task definitions and a reusable backlog. An integrated MCP server facilitates advanced orchestration of multiple agents, enhancing workflow automation.

Quick Start & Requirements

Install via Homebrew: brew install --cask 2mawi2/tap/schaltwerk && open -a Schaltwerk. Requires macOS 11+ and Git 2.30+. At least one agentic coding CLI (e.g., Copilot CLI, Claude Code, Gemini) or Terminal Only mode is necessary. Linux support is in alpha. Official documentation is available at https://schaltwerk.mintlify.app. Setup is estimated at 60 seconds.

Highlighted Details

• Native terminal integration for AI agents, bypassing wrappers and limitations.
• Efficient multi-agent coordination with instant session switching (⌘1-9) and clear activity overviews.
• Spec-driven development using Markdown for planning, execution, and reproducibility.
• Full control and privacy: no data tracking, supports private API endpoints.
• GitHub-style diff reviews with inline comments for agent feedback.
• Isolated Git worktrees per session ensure conflict-free parallel work.
• MCP server enables orchestrator agents for advanced workflow automation.

Maintenance & Community

The project actively welcomes contributions via CONTRIBUTING.md. GitHub Actions are utilized for automated testing and Homebrew tap updates. No specific community channels (Discord/Slack) or roadmap links were found in the provided README.

Licensing & Compatibility

Licensed under the MIT license, which permits broad commercial use and integration with closed-source projects.

Limitations & Caveats

Linux support is currently in an alpha state. The application requires macOS 11 (Big Sur) or later.