Agent Deck Vollständige Anleitung 2026: Alle KI-Coding-Agenten mit einem TUI verwalten

Dieser Artikel basiert auf Agent Deck v1.9.57 (veröffentlicht am 2026-06-12), die PR-Nummer hat bereits #1408 erreicht – das Projekt wird äußerst aktiv weiterentwickelt.

1. Warum brauchst du einen KI-Agenten-Manager?

Das Ökosystem der KI-Coding-Tools hat sich 2026 grundlegend verändert. Vor einem Jahr genügte den meisten Entwicklern ein einzelnes Tool wie Claude Code oder Aider. Heute kann ein typischer Workflow eines fortgeschrittenen Entwicklers so aussehen:

• Claude Code übernimmt die Kern-Geschäftslogik
• OpenCode führt Code-Reviews durch
• Codex schreibt Unit-Tests
• Gemini CLI dient der schnellen Prototypen-Validierung
• Pi erstellt Dokumentation

Hochgerechnet: 5 KI-Agenten × 3 Projekte = 15 Terminal-Tabs. Und das ohne die manuell geöffneten Debug-Terminals, Datenbank-Clients und Log-Viewer.

Terminal-Tab-Chaos

Folgende Szenarien dürften dir bekannt sein:

• Du vergisst, welcher Tab zu welchem Agenten gehört, und checkst den falschen Git-Branch aus
• Claude Code wartet auf deine Antwort, aber du findest den Tab nicht mehr
• Du möchtest Gesprächsverläufe zwischen mehreren Claude-Sitzungen übertragen – nur manuelles Kopieren und Einfügen ist möglich
• MCP-Konfigurationsdateien werden immer unübersichtlicher, bei jedem Projektwechsel muss alles manuell angepasst werden

Probleme bestehender Lösungen

Agent Deck wurde genau für dieses Problem entwickelt. Es ist kein KI-Coding-Tool – es ist das Kontrollzentrum für alle KI-Coding-Tools.

2. Was ist Agent Deck?

Agent Deck (GitHub: asheshgoplani/agent-deck) ist ein quelloffener Terminal-Sitzungsmanager, speziell für KI-Coding-Agenten entwickelt. Er basiert auf tmux und bietet eine TUI (Terminal User Interface) innerhalb eines einzelnen Terminal-Fensters, die dir Folgendes ermöglicht:

• Den Status aller KI-Agenten auf einen Blick sehen (laufend / wartet auf Eingabe / im Leerlauf / Fehler)
• Mit einem Klick zwischen Agenten wechseln
• Sitzungen forken und von bestehenden Gesprächen neue Denkrichtungen abzweigen
• MCP-Dienste und Claude Skills visuell verwalten
• Mehrere KI-Agenten remote überwachen und orchestrieren (Conductor-Funktion)

Kernidee: Nicht noch ein KI-Coding-Tool, sondern das Kontrollzentrum für den KI-Entwicklungs-Workflow im Terminal.

Kennzahlen

3. Installation und Ersteinrichtung (5 Minuten)

Installationsoptionen

Agent Deck bietet drei Installationsmethoden. Homebrew ist die bequemste Variante:

# Methode 1: Homebrew (empfohlen, funktioniert auf macOS und Linux)
brew install asheshgoplani/tap/agent-deck

# Methode 2: Schnelles Installationsskript
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash

# Methode 3: Go install
go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest

Erste Sitzung erstellen

Nach der Installation starte im Terminal:

# Agent Deck TUI starten und eine Sitzung namens project-alpha erstellen
agent-deck session start project-alpha

Du siehst nun eine tmux-basierte TUI-Oberfläche. Falls noch kein KI-Agent konfiguriert ist, führt dich Agent Deck durch die Einrichtung.

Grundlegende TUI-Navigation

Innerhalb der TUI sind folgende Navigationstastenkürzel besonders nützlich:

Suche nach Status filtern (sehr praktisch):

Gruppeninterne Navigation (ab v1.7.60 neue Alt+-Tastenkürzel, bleibt innerhalb der aktuellen Gruppe):

Intelligente Statusanzeige

Agent Deck erkennt den Status jedes Agenten durch intelligente Abfragen in Echtzeit:

Wartende Sitzungen erscheinen direkt in der tmux-Statusleiste: Drücke Ctrl+b, lass los, dann 1-6, um direkt zur entsprechenden Wartesitzung zu springen. Die Statusleiste zeigt dann:

⚡ [1] frontend [2] api [3] backend

4. Kernfunktionen in der Praxis

4.1 Sitzungen forken: Eine Funktion, mehrere Implementierungen, ohne Konflikte

Fork ist eine der differenzierendsten Funktionen von Agent Deck. Stell dir folgendes Szenario vor: Du hast mit Claude Code eine API-Schnittstelle entworfen und möchtest jetzt zwei verschiedene Implementierungsansätze ausprobieren. Der herkömmliche Weg: Eine neue Sitzung starten und die Anforderungen von vorne erklären. Mit Fork brauchst du nur:

# In der TUI, Cursor auf der zu forkenden Sitzung positionieren
# f drücken → Schnell-Fork (automatisch generierter Name)
# F drücken → Benutzerdefinierter Name und Gruppe nach dem Fork

Der Mehrwert von Fork:

• Die neue Sitzung übernimmt den kompletten Gesprächsverlauf der Elternsitzung
• Unterstützt nativen Fork für Claude / OpenCode / Pi / Codex (die eigene Fork-Funktion der Tools)
• Du kannst einen Fork erneut forken und beliebig viele Denkzweige erkunden
• Jeder Zweig arbeitet unabhängig, Vergleich ist jederzeit möglich

⚠️ Hinweis: Die Fork-Funktion von Codex benötigt die codex CLI-Version ≥ 0.137.0.

4.2 MCP Manager: MCP-Dienste verwalten, ohne Konfigurationsdateien anzufassen

MCP-Dienste (Model Context Protocol) ermöglichen KI-Agenten den Zugriff auf externe Tools (Websuche, Browser-Automatisierung, Datenbankabfragen etc.). Die herkömmliche Verwaltung erfordert manuelle JSON-Bearbeitung. Agent Deck macht daraus eine visuelle TUI-Operation:

Drücke m in der TUI, um den MCP Manager zu öffnen:

MCP-Konfigurationspfad: ~/.config/agent-deck/config.toml

Beispielkonfiguration:

[[mcp_servers]]
name = "web-search"
command = "npx"
args = ["-y", "@anthropic/mcp-server-brave-search"]

Nach der Konfiguration in der TUI startet Agent Deck die entsprechenden Agenten-Sitzungen automatisch neu, um die Änderungen anzuwenden – kein manuelles Neustarten nötig.

4.3 Skills Manager: Claude Skills projektbezogen verwalten

Für Claude-Code-Nutzer bietet Agent Deck einen integrierten Skills Manager zur poolbasierten Verwaltung von Claude Skills nach Projekt:

Drücke s in der TUI, um den Skills Manager zu öffnen (nur für Claude-Sitzungen):

• Pool-Verwaltung: Die verfügbaren Skills kommen ausschließlich aus dem Pool (~/.config/agent-deck/skills/pool), was attach/detach-Operationen vorhersehbar macht
• Projektstatus: Der Projektstatus wird in .agent-deck/skills.toml gespeichert, Skill-Dateien werden im .claude/skills-Verzeichnis materialisiert
• Tippen zum Springen: Dieselbe Namenseingabe-Interaktion wie beim MCP Manager

Das bedeutet, du kannst für verschiedene Projekte unterschiedliche Skill-Kombinationen konfigurieren:

• project-alpha: attached web-search + code-review Skills
• project-beta: attached api-testing + docs-generation Skills

4.4 MCP Socket Pool: 85 % Speicherersparnis bei mehreren Sitzungen

Wenn du mehrere Sitzungen gleichzeitig betreibst und jede denselben MCP-Dienst verbindet, vervielfacht sich der Speicherverbrauch. Der MCP Socket Pool von Agent Deck lässt mehrere Sitzungen über einen Unix Socket denselben MCP-Prozess teilen:

# In der config.toml aktivieren
[mcp]
pool_all = true

Effekte:

• 85–90 % weniger MCP-Speicherverbrauch
• Bei MCP-Prozessabsturz: automatische Wiederverbindung in ca. 3 Sekunden (Reconnecting-Proxy)
• Für die darüberliegenden Agenten völlig transparent, kein Code-Change nötig

4.5 Unabhängige Claude-Konfiguration pro Gruppe

Wenn du auf derselben Maschine mehrere Claude-Konten verwaltest (z. B. privates und geschäftliches Konto), unterstützt Agent Deck unterschiedliche Claude-Authentifizierungen pro Gruppe:

# config.toml
[groups."conductor".claude]
config_dir = "~/.claude-work"
env_file = "~/git/work/.envrc"

Suchpriorität: Umgebungsvariable > Gruppe > Konfigurationsdatei (Profil) > Global > Standard

Die env_file wird geladen, bevor der tmux-Pane startet. Die darin enthaltenen export-Anweisungen werden Teil der Sitzungsumgebung. Das ist besonders praktisch für Szenarien mit verschiedenen API-Keys oder unterschiedlichen Claude-Arbeitsverzeichnissen.

5. Fortgeschrittene Nutzung: Conductor-Orchestrierung

Was ist Conductor?

Wenn die Sitzungsverwaltung von Agent Deck der „Autopilot" ist, dann ist Conductor der „Flottenkommandant". Es handelt sich um eine höhere Abstraktionsebene, mit der du alle KI-Agenten-Sitzungen remote über Telegram, Slack oder Discord überwachen und orchestrieren kannst.

Telegram-Überwachung in fünf Minuten einrichten

# 1. Erstelle einen Telegram-Bot über @BotFather und notiere dir den Token
# 2. Hole deine User-ID über @userinfobot

# 3. Ein-Klick-Assistent (konfiguriert automatisch Conductor, Bridge-Daemon und Heartbeat)
agent-deck conductor setup work --description "Work fleet"

# 4. Conductor-Sitzung starten
agent-deck session start conductor-work

# 5. Sende /status an deinen Bot in Telegram

Ab diesem Moment werden alle deine Agent-Deck-Sitzungen von einer zentralen Conductor-Sitzung überwacht:

• Routineprobleme werden automatisch behandelt
• Wichtige Ereignisse werden auf dein Handy gepusht
• Wartende Arbeiten „vergammeln" nicht und geraten nicht in Vergessenheit

Watcher-Einrichtung: Externe Ereignisse wecken KI-Agenten

Neben aktiven Abfragen kannst du Watcher konfigurieren, die externe Ereignisse (GitHub-Events, Gmail, ntfy-Push, Meeting-Erinnerungen etc.) als „Türklingel" für den Conductor nutzen. Details dazu findest du in der offiziellen Watcher-Dokumentation.

6. Agent Deck im Vergleich mit anderen Lösungen

7. Fazit

Agent Deck löst nicht die Frage „Welches KI-Coding-Tool ist besser?" – es löst das Problem: Wenn du mehrere KI-Tools nutzt, wie bekommst du sie zum Zusammenarbeiten, ohne verrückt zu werden?

Die wichtigsten Vorteile im Überblick:

1. Zentrale Steuerung: Ein Terminal-Fenster für alle KI-Agenten – Schluss mit Tab-Chaos
2. Sitzungen forken: Von bestehenden Gesprächen neue Denkrichtungen abzweigen, ohne alles neu zu erklären
3. Visuelle MCP-/Skills-Verwaltung: Nie wieder Konfigurationsdateien manuell bearbeiten
4. MCP Socket Pool: Deutlich weniger Speicherverbrauch bei mehreren Sitzungen
5. Conductor-Remote-Überwachung: KI-Agenten-Status jederzeit über Telegram/Slack im Blick
6. Git-Worktree-Integration: Mehrere Agenten entwickeln am selben Repo, ohne Konflikte

Wenn du dich bereits mit „zu vielen KI-Agenten" konfrontiert siehst, ist Agent Deck die ausgereifteste Open-Source-Lösung in diesem Segment. Das Projekt entwickelt sich rasant (v1.9.56 → v1.9.57 in nur 4 Stunden) und die Community ist aktiv (PR #1408+) – absolut empfehlenswert, es im Auge zu behalten.

Weiterführende Links:

• 📦 Agent Deck GitHub-Repository
• 📋 Neueste Versionshinweise
• 📖 Vollständige Conductor-Konfigurationsanleitung
• 📖 Watcher-Einrichtungsanleitung
• 💬 Discord-Community

Empfohlene Artikel:

• Aider Vollständige Anleitung – Git-first Terminal-KI-Programmierassistent
• CC Switch Multi-Modell-KI-Coding-Verwaltung