cmuxLayer

Name: cmuxlayer
Author: EtanHey

Deine KI-Agenten können die Terminals der jeweils anderen nicht sehen. Einer läuft in Tab 1, ein anderer in Tab 2 – und du bist die Zwischenablage zwischen ihnen. cmuxLayer behebt das: 22 MCP-Tools, die KI-Agenten eine programmatische Kontrolle über Terminal-Arbeitsbereiche geben.

install License MCP Tools Tests

Schnellstart

npm install -g cmuxlayer

Erfordert, dass cmux läuft.

Füge dies zu deiner MCP-Konfiguration hinzu (Claude Code, Cursor, VS Code, Claude Desktop):

{
  "mcpServers": {
    "cmux": {
      "command": "cmuxlayer"
    }
  }
}

Konfigurationspfade: Claude Code .mcp.json oder claude mcp add cmuxlayer -s user -- cmuxlayer | Cursor .cursor/mcp.json | VS Code .vscode/mcp.json | Claude Desktop — siehe MCP-Dokumentation für plattformspezifische Pfade

Was du tun kannst

Sage deinem KI-Agenten Dinge wie:

"Teile einen Bereich nach rechts und führe dort meine Test-Suite aus"
"Erstelle einen Claude Code-Agenten in einem neuen Bereich, um auth.ts zu refactoren"
"Lies den Bildschirm von surface:2 und sag mir, ob der Build erfolgreich war"
"Warte, bis alle Agenten fertig sind, und lies dann ihre Ausgabe"
"Setze den Status der Seitenleiste, um unseren Deployment-Fortschritt anzuzeigen"

Unter der Haube stellt cmuxLayer 22 MCP-Tools für Terminalsteuerung, Bildschirmlesen und Multi-Agenten-Orchestrierung bereit. read_screen analysiert Agenten-Metadaten (Status, Modell, Token, Kontext-%) für Claude Code, Codex, Gemini, Cursor und Kiro.

MCP-Tools (22)

Alle Tools werden mit ToolAnnotations für die automatische Durchsetzung von Sicherheitsrichtlinien ausgeliefert.

Terminalsteuerung — new_split send_input send_key read_screen rename_tab close_surface browser_surface

Agenten-Lebenszyklus — spawn_agent send_to_agent wait_for wait_for_all interact stop_agent kill

Arbeitsbereich — list_surfaces list_agents my_agents get_agent_state read_agent_output notify set_status set_progress

Nur Lesen (6)

Tool	Was es tut
`list_surfaces`	Listet alle Oberflächen über Arbeitsbereiche hinweg auf
`read_screen`	Liest Terminalausgabe mit analysiertem Agentenstatus
`get_agent_state`	Vollständiger Status eines verfolgten Agenten
`list_agents`	Alle Agenten, mit optionalen Filtern
`my_agents`	Kinder eines übergeordneten Agenten mit Live-Bildschirmstatus
`read_agent_output`	Strukturierte Ausgabe zwischen Trennmarkierungen

Verändernd (13)

Tool	Was es tut
`new_split`	Erstellt einen Terminal- oder Browser-Split-Bereich
`send_input`	Sendet Text an eine Oberfläche
`send_key`	Sendet Tastendruck (Return, Escape, Strg-C, etc.)
`rename_tab`	Benennt einen Oberflächen-Tab um
`notify`	Zeigt ein cmux-Benachrichtigungsbanner an
`set_status`	Setzt Schlüssel-Wert-Paar für den Seitenleistenstatus
`set_progress`	Setzt Fortschrittsanzeige (0.0-1.0)
`browser_surface`	Interagiert mit Browser-Oberflächen
`spawn_agent`	Startet einen CLI-Agenten in einem neuen Bereich
`send_to_agent`	Sendet einen Prompt an einen laufenden Agenten
`wait_for`	Blockiert, bis der Agent einen Zielstatus erreicht
`wait_for_all`	Blockiert, bis mehrere Agenten fertig sind
`interact`	Sendet interaktive Eingaben (bestätigen, abbrechen, fortsetzen)

Destruktiv (3)

Tool	Was es tut
`close_surface`	Schließt einen Terminal- oder Browser-Bereich
`stop_agent`	Stoppt einen Agenten ordnungsgemäß
`kill`	Erzwingt das Beenden von Agentenprozessen

Unterstützte Agenten

CLI	Befehl	Automatisch erkannt
Claude Code	`claude`	Status, Modell, Token, Kontext-%
Codex	`codex`	Status, Modell
Gemini CLI	`gemini`	Status, Modell
Cursor	`cursor agent`	Status
Kiro	`kiro-cli`	Status

read_screen erkennt automatisch den Agententyp und analysiert Metadaten aus der Terminalausgabe.

Architektur

AI Agent  ─── MCP ───>  cmuxLayer  ─── Unix socket ───>  cmux
                         ├── Agent engine (spawn → monitor → teardown)
                         ├── Screen parser (5 agent formats)
                         ├── Mode policy (autonomous vs manual)
                         └── State manager + event log

Der Socket-Client verbindet sich über einen Unix-Socket mit cmux. Verbindet sich bei Trennung automatisch neu und greift auf CLI-Subprozesse zurück, falls der Socket nicht verfügbar ist.

Verbindung	Latenz	Beschleunigung
CLI-Subprozess	~142ms	Basislinie
Unix-Socket	~0.1ms	1.423x

Fehlerbehebung

cmux läuft nicht cmuxLayer erfordert eine laufende cmux-Instanz. Installiere es zuerst und starte dann eine cmux-Sitzung, bevor du cmuxLayer verwendest.

Tools erscheinen nicht in Claude Code Starte Claude Code neu, nachdem du die MCP-Konfiguration hinzugefügt hast. Führe claude mcp list aus, um zu überprüfen, ob cmuxlayer verbunden ist.

Socket-Verbindung fehlgeschlagen cmuxLayer erkennt den cmux-Socket automatisch (macOS: ~/Library/Application Support/cmux/cmux.sock). Überschreibe dies bei Bedarf mit CMUX_SOCKET_PATH.

Testen

npm test            # 335 tests via vitest
npm run typecheck   # Type checking

Entwicklung

npm install
npm run dev         # Run with tsx (hot reload)
npm run build       # Compile TypeScript
npm start           # Run compiled output

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung und PR-Richtlinien.

Lizenz

Apache 2.0 — siehe LICENSE.

Teil des Golems KI-Agenten-Ökosystems. cmuxlayer.etanheyman.com | Erstellt von @EtanHey.

cmuxlayer