> ## Documentation Index
> Fetch the complete documentation index at: https://schaltwerk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Schaltwerk keeps every AI coding session in its own git worktree

## What is Schaltwerk?

Run multiple AI agents on the same codebase—safely. Each agent works in an isolated [git worktree](https://git-scm.com/docs/git-worktree), with its own branch, terminals, and state.

<video controls muted playsInline className="w-full aspect-video rounded-lg shadow-lg my-8" src="https://mintcdn.com/schaltwerk/KG1elAstw6eFgx9E/videos/workflow.mp4?fit=max&auto=format&n=KG1elAstw6eFgx9E&q=85&s=4693427cf0af1143dfe4ed3fe760e4cf" data-path="videos/workflow.mp4">
  Your browser does not support the video tag.
</video>

## Quick Start (1 Minute)

<Steps>
  <Step title="Install">
    ```bash theme={null}
    brew install --cask 2mawi2/tap/schaltwerk
    open -a Schaltwerk
    ```
  </Step>

  <Step title="Open your project">
    Select your git repository in Schaltwerk
  </Step>

  <Step title="Start an agent">
    Press `⌘N` to create a new session:

    * Enter a task description
    * Select your agent (GitHub Copilot, Claude Code, OpenCode, Codex, Gemini, Kilo Code, Qwen, Factory Droid, Amp, or Terminal Only)
    * Choose the base branch
    * Press `⌘Enter` to start
  </Step>

  <Step title="Watch it work">
    The agent starts in the sidebar in its own isolated [git worktree](https://git-scm.com/docs/git-worktree) and branch. Monitor progress in the top terminal.
  </Step>

  <Step title="Review and merge">
    When done, merge to main with `⌘⇧M` or create a PR with `⌘⇧P`. Optionally press `⌘R` to mark as reviewed first.
  </Step>
</Steps>

## Get Started

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/installation">
    Install Schaltwerk on macOS, Windows, or Linux
  </Card>

  <Card title="Your First Session" icon="rocket" href="/first-session">
    Create and run your first agent
  </Card>

  <Card title="Workflow" icon="arrows-rotate" href="/workflow">
    Best practices for daily use
  </Card>

  <Card title="Core Concepts" icon="book" href="/core-concepts">
    Understand sessions, specs, and orchestrator
  </Card>
</CardGroup>

## Key Features

* **Isolated Git Worktrees** - Each session gets its own branch and worktree
* **Dual Terminals** - Agent terminal on top, your shell below
* **Spec-Driven** - Plan in markdown, then execute
* **Orchestrator** - Coordinate multiple sessions from your primary branch (main or a feature hub)
* **Web Preview** - View localhost dev servers directly in the app with auto-detection and element inspection
* **MCP API** - Automate session management via REST

## Platform Support

<Info>
  **macOS, Windows, and Linux** - Apple Silicon and Intel Macs supported. Windows 10/11 (native, WSL not yet supported). Linux via beta builds.
</Info>

***

<sup>[Privacy](/privacy) · [Imprint](/imprint)</sup>