Zum Inhalt springen
Kostenlos und Open Source

Doku

KI-Assistenten erledigen Programmieraufgaben. Dieser Leitfaden erklärt Kommandozeilenwerkzeuge (CLI), Terminalmenüs (TUI), das Terminalwerkzeug tmux für laufende Aufgaben und eine Standardverbindung zwischen KI-Werkzeugen (MCP).

Installation

Du brauchst macOS, Linux oder WSL, Node 22.12 oder neuer, tmux 3.0 oder neuer und mindestens eine Anbieter-CLI, die installiert und eingeloggt ist.

$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagents
reevesagents doctor prüft all das. reevesagents setup führt dieselben Checks als Assistent für den ersten Start aus und verbindet mit --attach außerdem den MCP-Server mit jedem installierten Host.

Schnellstart

Ein Team starten, nachsehen, eingreifen und wieder stoppen.

Ein Team starten

shell
reevesagents spawn cc:lead codex:api kimi:docs \
  --name "feature x" --prompt "Build feature X. The lead splits the work."

Jeder Assistent wird als provider[:nickname[:model]] geschrieben, und der erste übernimmt die Führung. Mit reevesagents add fügst du dem jüngsten Run weitere Assistenten hinzu.

Zuschauen und lenken

shell
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open api

send fügt Text ein, ohne ihn abzuschicken. Schick deshalb key <agent> enter hinterher. open bringt dich in tmux direkt zum Assistenten.

Stoppen

shell
reevesagents stop "feature x" --yes
stop, kill und die delete-Befehle brauchen --yes (oder ALLOW_DESTRUCTIVE=1).

Terminalmenü, Browser und Befehle

Menü (TUI), Browseroberfläche und Kommandozeilenwerkzeug (CLI) teilen Aufgabeneinträge unter ~/.reeves. Das Terminalwerkzeug tmux hält die Assistenten am Laufen.

  • Tipp reevesagents ohne Argumente ein, um die TUI zu öffnen. Sie packt sich selbst in eine tmux-Session namens reeves. Mit REEVES_NO_TMUX_WRAPPER=1 schaltest du das ab.
  • reevesagents web startet die Web-UI auf 127.0.0.1, auf Port 8080 oder dem nächsten freien. Sie weist Host-Header ab, die nicht auf Loopback zeigen, ebenso schreibende Anfragen von fremden Origins. Ctrl+C beendet sie, ohne deine Assistenten anzufassen.
  • Alles gibt es auch als CLI-Befehl. Skripte sollten --json lesen, denn die normale Textausgabe kann sich zwischen Versionen ändern.
  • Darunter liegt tmux, mit einer Session pro Run und einem Fenster pro Assistent. reevesagents open <id> springt von überall aus ins richtige Fenster.

Agentensteuerung (MCP)

Verbinde ein Programmierwerkzeug über ein Standardprotokoll (MCP) mit den anderen. Das ist optional. Starte das Werkzeug danach neu.

shell
reevesagents attach cc
reevesagents hosts
  • Sechs CLIs können ihn hosten: Claude Code, Codex, Kimi Code, Qwen Code, Hermes und OpenCode. reevesagents attach ohne Namen hängt ihn an alle installierten, und reevesagents detach <cli> entfernt ihn wieder.
  • Der Host bekommt schlichte Tools, um Assistenten zu starten, Text einzufügen, Tasten zu drücken, Ausgabe zu lesen und Freigaben zu entscheiden. Was das Team tut, entscheidet, wer den Host promptet.
  • Gestartete Worker bekommen die Tools erst, wenn du auch ihre CLI anhängst. Beim Starten über MCP wird max_agents (standardmäßig 100) als Agentenlimit pro Run durchgesetzt.

Befehle

Alle Unterbefehle von reevesagents. Ohne Argumente öffnet es die TUI.

Runs

spawn [spec...]

Startet einen Run. Jede Spec lautet provider[:nickname[:model]], der erste Agent übernimmt die Führung. Flags: --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

Fügt dem jüngsten aktiven Run Agenten hinzu. Flags: --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. Mindestens eine Spec ist nötig.

runs

Listet aktive Runs auf. --json.

open <id>

Springt in tmux zum Fenster eines Runs oder Agenten. Akzeptiert ID, Namen, Nickname oder ein eindeutiges Präfix.

peek <agent-id>

Gibt die letzte Ausgabe eines Agenten aus. -n/--lines (Standard 20), --json.

stop <run-id>braucht --yes

Stoppt einen Run und baut seine tmux-Session ab. -y/--yes.

kill <agent-id>braucht --yes

Stoppt einen Agenten. Der Run endet mit seinem letzten aktiven Agenten. -y/--yes.

Einen Assistenten steuern

send <agent-id> <text...>

Fügt Text am Prompt des Agenten ein, ohne ihn abzuschicken.

key <agent-id> <key>

Sendet eine erlaubte Taste: enter, escape, backspace, tab, space, up, down, left, right, ctrl-c.

interrupt <agent-id>

Sendet ctrl-c.

Einträge und Verlauf

agents [run-id]

Listet die Agenten aller aktiven Runs oder eines bestimmten Runs auf. --json.

providers

Listet Anbieter mit Verfügbarkeit und bekannten Modellen auf. --models, --json.

tools

Listet die Agentenwerkzeuge mit Installations- und Anmeldestatus auf. --json.

delete <agent-id>braucht --yes

Löscht den Eintrag eines beendeten Agenten. -y/--yes.

delete-run <run-id>braucht --yes

Löscht einen beendeten Run. -y/--yes.

history

Listet archivierte Runs auf. --json.

delete-history <id>braucht --yes

Löscht einen Verlaufseintrag. -y/--yes.

Freigaben

approvals

Listet offene Freigaben auf. --json.

approve <approval-id> [note]

Genehmigt eine Freigabe.

deny <approval-id> [note]

Lehnt eine Freigabe ab.

MCP-Hosts

hosts

Listet MCP-fähige Host-CLIs auf und zeigt, welche angehängt sind. --json.

attach [cli]

Hängt den MCP an eine Host-CLI oder an alle installierten Hosts an, über deren CLI oder Konfigurationsdatei. --force überschreibt eine vorhandene Registrierung.

detach <cli>

Entfernt den MCP-Server aus einer Host-CLI, über deren CLI oder Konfigurationsdatei.

mcp

Startet den MCP-Server der Agentensteuerung über stdio. Die Host-CLI führt ihn aus.

Config und Presets

config [key] [value]

Zeigt die Config an oder liest bzw. setzt ein bearbeitbares Feld. --json.

presets

Listet gespeicherte Presets auf. --json.

save-preset <run-id> <name> [description...]

Speichert einen laufenden Run als Preset.

start-preset <name>

Startet einen Run aus einem Preset. --name, --cwd.

delete-preset <name>braucht --yes

Löscht ein Preset. -y/--yes.

Einrichtung und Tools

setup

Prüft beim ersten Start tmux, Node und die installierten CLIs. --attach verbindet alle installierten Hosts. --json gibt den Onboarding-Status aus.

doctor

Führt Health-Checks für die Umgebung aus. Bei einem Fehler endet es mit einem Exit-Code ungleich null. --json.

skills [action]

Installiert, entfernt oder prüft den ReevesAgents-Skill für Skill-fähige CLIs (install, remove, status; Standard ist status). --json.

reap

Beendet Agenten, deren Fenster verschwunden ist oder die max_lifetime_ms überschritten haben, und schließt verwaiste tmux-Sessions. --json.

web

Startet die Web-UI, die nur auf Loopback lauscht, im Vordergrund. --port, --no-open.

MCP-Tools

Die 31 Tools, die eine angehängte CLI aufrufen kann, gruppiert nach Zweck.

Starten und steuern

spawnerforderlichprovideroptionalrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

Startet einen Worker. Ohne run_id wird der Run dieser MCP-Session verwendet, der beim ersten Spawn entsteht. Mit run_id geht der Worker in einen anderen Run.

killerforderlichagent_id

Stoppt einen Agenten.

stoperforderlichrun_id

Stoppt einen ganzen Run und baut seine tmux-Session ab.

send_texterforderlichagent_idtext

Fügt Text am Prompt eines Agenten ein, ohne ihn abzuschicken.

send_keyerforderlichagent_idkey

Sendet eine erlaubte Taste (enter, escape, ctrl-c, …).

interrupterforderlichagent_id

Sendet ctrl-c an einen Agenten.

readerforderlichagent_idoptionallines

Liest die letzte Pane-Ausgabe ohne ANSI-Sequenzen und mit geschwärzten Geheimnissen. Standard: 20 Zeilen.

Inspizieren

list

Listet Runs und Agenten auf.

list_providers

Anbieter- und Modellkatalog dieses Rechners.

list_tools

Werkzeugkatalog dieses Rechners: Hilfs-CLIs, die ein Agent aus seiner eigenen Shell ausführen kann, mit Installations- und Anmeldestatus.

list_history

Archivierte Runs.

list_presets

Gespeicherte Presets.

list_hosts

MCP-fähige CLIs und welche davon angehängt sind.

get_config

Aktuelle globale Config.

doctor

Health-Checks für die Umgebung.

Freigaben

request_approvalerforderlichagent_idactionsummaryoptionaldetailsrisk

Stellt eine Freigabeanfrage.

resolve_approvalerforderlichapproval_iddecisionoptionalnote

Genehmigt eine offene Anfrage oder lehnt sie ab.

check_approvalerforderlichapproval_id

Liest eine Freigabe.

list_approvalsoptionalrun_idstatus

Listet Freigaben auf, filterbar.

Lebenszyklus

deleteerforderlichagent_id

Löscht den Eintrag eines beendeten Agenten.

delete_runerforderlichrun_id

Löscht einen beendeten Run.

delete_historyerforderlichid

Löscht einen Verlaufseintrag.

openerforderlichid

Schaltet den angehängten tmux-Client auf einen Run oder Agenten um.

reap

Räumt jetzt Agenten mit verschwundenem Fenster oder abgelaufener Lebensdauer sowie verwaiste tmux-Sessions auf.

Config und Presets

set_configoptionalpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguage

Setzt ein oder mehrere bearbeitbare Config-Felder.

save_preseterforderlichrun_idnameoptionaldescription

Speichert einen laufenden Run als Preset.

start_preseterforderlichnameoptionalrun_nameworking_dir

Startet einen Run aus einem Preset.

delete_preseterforderlichname

Löscht ein Preset.

Hosts und Skills

attach_hostoptionalkey

Hängt den MCP an eine Host-CLI oder an alle an.

detach_hosterforderlichkey

Entfernt den MCP-Server aus einer Host-CLI.

install_skillsoptionalstatus

Installiert den ReevesAgents-Skill für Skill-fähige CLIs oder zeigt, wo er liegt.

Zwei Ressourcen liefern den Anbieterkatalog und eine Anleitung zur Nutzung: reevesagents://providers, reevesagents://guide

Konfiguration

Die Einstellungen liegen in ~/.reeves/config.json. Ändern kannst du sie mit reevesagents config <key> <value> oder über die Einstellungs-Screens. reevesagents config language tr stellt die Oberfläche auf eine ihrer zehn Sprachen um.

Felder

peek_interval_ms5000

Gespeicherte Einstellung für das Abfrageintervall. Die aktuellen Oberflächen nutzen feste Aktualisierungsintervalle.

peek_lines10

Gespeicherte Einstellung für die Zeilenzahl. Aktuelle Screens sowie CLI- und MCP-Lesezugriffe nutzen eigene Zeilenzahlen.

max_agents100

Obergrenze für aktive Agenten pro Run, die MCP-Spawns durchsetzen. Andere Startwege setzen sie nicht durch.

max_depth5

Gespeicherte Einstellung für die Rekursionstiefe. Die aktuelle Run-Engine setzt sie nicht durch.

ready_delay_ms5000

Wartezeit, bis sich eine frische CLI beruhigt hat, bevor ein Prompt eingefügt wird.

max_lifetime_ms0

Beendet Agenten, die älter sind als dieser Wert. 0 schaltet das ab.

default_permissionsask

Standard-Berechtigungsmodus für neue Agenten: ask oder skip.

languageen

Sprache der Oberfläche, einer der zehn Sprachcodes.

Gespeicherter Zustand

~/.reeves/
  config.json
  presets/<name>.json
  runs/<run-id>/
    run.json
    agents/<agent-id>.json
    approvals/<approval-id>.json
  history/runs/<run-id>.json

Überschreiben per Umgebungsvariable

REEVES_REGISTRY

Überschreibt das State-Stammverzeichnis (Standard ~/.reeves).

REEVES_CONFIG

Überschreibt den Pfad der Config-Datei.

REEVES_NO_TMUX_WRAPPER=1

Mit 1 wird die TUI nicht automatisch in eine tmux-Session gepackt.

REEVES_NO_COLOR=1

Mit 1 werden die TUI-Farben abgeschaltet.

ALLOW_DESTRUCTIVE=1

Mit 1 laufen destruktive Befehle auch ohne --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

Mit 1 überspringt doctor die Prüfung der Anbieter-Kompatibilität.

Anbieter

25 CLIs, jede mit einer kurzen ID für die Spawn-Spec. Die Modelllisten sind Vorschläge, und jede Modell-ID, die du übergibst, geht unverändert an den Anbieter.

  • Claude CodeMCP-Host

    Programmieragent von Anthropic für das Terminal

    ID ccBinary claude

    vorgeschlagene Modelle fable, opus, sonnet, haiku

  • Codex CLIMCP-Host

    Programmieragent-CLI von OpenAI

    ID codexBinary codex

    vorgeschlagene Modelle gpt-5.6-sol, gpt-5.5, gpt-5.4-mini

  • OpenCode CLIMCP-Host

    Quelloffener Programmieragent für das Terminal

    ID opencodeBinary opencode

    vorgeschlagene Modelle opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5

  • HermesMCP-Host

    Agent-CLI von Nous Research

    ID hermesBinary hermes

    vorgeschlagene Modelle anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini

  • Kimi CodeMCP-Host

    Programmier-CLI von Moonshot AI

    ID kimiBinary kimi

    vorgeschlagene Modelle kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed

  • DeepSeek CLI

    Programmier-CLI von DeepSeek

    ID deepseekBinary deepseek

    vorgeschlagene Modelle deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Minimales Programmier-Harness für das Terminal

    ID piBinary pi

    vorgeschlagene Modelle sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeMCP-Host

    Programmieragent-CLI von Alibaba

    ID qwenBinary qwen

    vorgeschlagene Modelle qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    KI-Pair-Programming im Terminal

    ID aiderBinary aider

    vorgeschlagene Modelle sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Quelloffener Terminal-Agent von Google

    ID geminiBinary gemini

    vorgeschlagene Modelle gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite

  • Cline CLI

    Autonomer Programmieragent als CLI

    ID clineBinary cline

    vorgeschlagene Modelle anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro

  • Crush

    Programmieragent von Charm für das Terminal

    ID crushBinary crush

    vorgeschlagene Modelle wird in der CLI selbst gewählt

  • Goose

    Quelloffener KI-Agent für allgemeine Aufgaben

    ID gooseBinary goose

    vorgeschlagene Modelle claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro

  • Kilo Code

    Quelloffener Programmieragent mit CLI

    ID kiloBinary kilo

    vorgeschlagene Modelle kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest

  • Letta Code

    Programmieragent mit Langzeitgedächtnis

    ID lettaBinary letta

    vorgeschlagene Modelle zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct

  • Mistral Vibe

    Programmieragent-CLI von Mistral

    ID vibeBinary vibe

    vorgeschlagene Modelle wird in der CLI selbst gewählt

  • Grok Build

    Programmieragent-CLI von xAI

    ID grokBinary grok

    vorgeschlagene Modelle grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    Agentische Programmier-CLI von AWS

    ID kiroBinary kiro-cli

    vorgeschlagene Modelle claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6

  • Factory Droid

    Programmieragent-CLI von Factory

    ID droidBinary droid

    vorgeschlagene Modelle wird in der CLI selbst gewählt

  • Qoder CLI

    Agentische Programmier-CLI von Qoder

    ID qoderBinary qodercli

    vorgeschlagene Modelle auto, performance, lite

  • Warp

    Agent von Warp im Terminal

    ID warpBinary warp

    vorgeschlagene Modelle wird in der CLI selbst gewählt

  • Junie CLI

    Programmieragent-CLI von JetBrains

    ID junieBinary junie

    vorgeschlagene Modelle sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    Programmieragent-CLI von GitHub

    ID copilotBinary copilot

    vorgeschlagene Modelle auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    Programmieragent-CLI von Cursor

    ID cursorBinary cursor-agent

    vorgeschlagene Modelle gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    Programmieragent-CLI von Atlassian

    ID rovoBinary acli

    vorgeschlagene Modelle wird in der CLI selbst gewählt

  • --effort setzt den Reasoning-Aufwand für Claude Code und Codex. --auth-mode api-key gilt für Claude Code.
  • Jedes andere Start-Flag übergibst du mit --extra-args, zum Beispiel Claude Codes --remote-control.
  • Lass die Berechtigungsabfragen aktiviert. --skip schaltet sie in den Programmierwerkzeugen aus.

Tools für Agenten

Vier Hilfs-CLIs, die ein Agent aus seiner eigenen Shell aufrufen kann. Sie nehmen keine Chat-Aufgabe an und sind deshalb keine startbaren Anbieter. reevesagents tools listet sie mit Installations- und Anmeldestatus auf.

  • Perplexity CLIpplx

    Websuche und Seitenausschnitte von Perplexity als JSON.

  • Google Colab CLIcolab

    CPU-, GPU- und TPU-Laufzeiten auf Google Colab: Skripte und Notebooks aus der Ferne ausführen.

  • Hugging Face CLIhf

    Modelle und Datensätze herunter- und hochladen, Jobs auf dem Hugging Face Hub ausführen.

  • Ollamaollama

    Lokale oder Ollama-Cloud-Modelle im Terminal ausführen.

Fehlerbehebung

Fang mit reevesagents doctor an. Meistens nennt es das Problem beim Namen.

tmux fehlt

Installier es mit brew install tmux oder sudo apt install tmux und führ danach doctor erneut aus.

Ein Anbieter taucht nicht auf

Meistens ist die CLI nicht installiert oder nicht eingeloggt. Behebe das und prüfe es dann mit reevesagents providers.

Die Web-UI meldet fehlende Pakete

Das Live-Terminal braucht die optionalen Module ws und @lydell/node-pty. Eine erneute globale Installation mit npm oder pnpm holt sie zurück.

Port 8080 ist belegt

Die Web-UI weicht auf den nächsten freien Port aus und gibt die URL aus. Einen bestimmten Port wählst du mit reevesagents web --port 8090.

Natives Windows

Das komplette Produkt läuft in WSL. Nur für die Agentensteuerung läuft reevesagents-win nativ als MCP-Server.

Zahlen mit Quellen

Downloadzeitraum: 2025-04-14 bis 2026-10-14. GitHub- und npm-Zahlen geprüft am 2026-10-15. Downloads zählen Paketabrufe.

Zuletzt aktualisiert: