Befehle & Flags - Devin Docs

Verwendung

devin [OPTIONS] [prompt]

Geben Sie optional einen Prompt an, um eine Sitzung mit einer ersten Nachricht zu starten, oder starten Sie interaktiv ohne Argumente. Sie können diese Informationen auch in Ihrem Terminal mit man devin aufrufen.

Globale Flags

Flag	Kurz	Beschreibung
`--model <MODEL>`		Das KI-Modell für diese Sitzung festlegen
`--permission-mode <MODE>`		Berechtigungsmodus (`normal`, `dangerous`, `bypass`)
`--continue`	`-c`	Die zuletzt verwendete Sitzung im aktuellen Verzeichnis fortsetzen
`--resume <SESSION_ID>`	`-r`	Eine bestimmte Sitzung anhand der ID fortsetzen
`--print [PROMPT]`	`-p`	Antwort ausgeben und beenden (nicht interaktiver Modus). Optional kann ein Inline-Prompt übergeben werden.
`--prompt-file <FILE>`		Den anfänglichen Prompt aus einer Datei laden
`--config <PATH>`		Pfad zur Konfigurationsdatei
`--export [PATH]`		Unterhaltung nach jeder Runde in eine Datei exportieren (ATIF-Format). Verwendet einen Standardpfad, wenn keiner angegeben ist.
`--respect-workspace-trust`		Ob die Workspace-Trust-Settings berücksichtigt werden

Beispiele:

devin -- add a login page
devin --model opus -- refactor the auth module
devin -c                              # Letzte Sitzung fortsetzen
devin -r abc12345                     # Bestimmte Sitzung fortsetzen
devin -p "list all TODO comments"    # Antwort ausgeben und beenden
devin -p -- list all TODO comments    # Dasselbe mit -- Trennzeichen (funktioniert ebenfalls)
devin --export -- fix the tests       # Unterhaltung in Standardpfad exportieren
devin --export out.json -- fix tests   # In eine bestimmte Datei exportieren

Unterbefehle

devin auth

Befehle für die Authentifizierung.

Befehl	Beschreibung
`devin auth login`	Bei Ihrem Benutzerkonto anmelden
`devin auth logout`	Abmelden und gespeicherte Zugangsdaten entfernen
`devin auth status`	Authentifizierungsstatus prüfen

Optionen für devin auth login:

--force-manual-token-flow — Browserbasierte Authentifizierung überspringen und manuell ein Token einfügen (nützlich für Remote-/SSH-Sitzungen)

devin mcp

Stelle eine Verbindung zu Model Context Protocol-Servern her und melde dich bei ihnen an.

Command	Beschreibung
`devin mcp add <name>`	Einen neuen MCP-Server hinzufügen
`devin mcp list`	Alle konfigurierten MCP-Server auflisten
`devin mcp get <name>`	Details zu einem bestimmten MCP-Server anzeigen
`devin mcp remove <name>`	Einen konfigurierten MCP-Server entfernen
`devin mcp login <name>`	Sich über OAuth bei einem MCP-Server authentifizieren
`devin mcp logout <name>`	Gespeicherte OAuth-Anmeldedaten für einen MCP-Server entfernen
`devin mcp enable <name>`	Einen deaktivierten MCP-Server aktivieren
`devin mcp disable <name>`	Einen MCP-Server deaktivieren, ohne ihn zu entfernen

Optionen für devin mcp add:

-t, --transport <stdio|http> — Transporttyp (optional; wird aus der URL → http bzw. aus nachgestellten Argumenten → stdio abgeleitet)
-s, --scope <local|project|user> — Konfigurations-Geltungsbereich (Standard: local)
--url <URL> — URL für den HTTP-Transport (kann auch als Positionsargument nach dem Namen übergeben werden)
--command <CMD> — Befehl für den stdio-Transport (optional, wenn nachgestellte Argumente angegeben werden)
-e, --env <KEY=VALUE> — Umgebungsvariablen (mehrfach verwendbar)
-H, --header <HEADER: VALUE> — HTTP-Header (mehrfach verwendbar)
--scopes <SCOPE,SCOPE> — Anzufordernde OAuth-Geltungsbereiche (kommagetrennt)
--oauth-resource <RESOURCE> — Den in OAuth-Anfragen gesendeten RFC-8707-Parameter resource überschreiben (Standard: die MCP-Server-URL; übergib einen leeren String, um ihn bei Anbietern wegzulassen, die ihn ablehnen)
<URL> — Positionsargument für HTTP (Alternative zu --url)
-- <COMMAND> [ARGS...] — Befehl und Argumente für stdio (das erste Argument ist der Befehl, wenn --command weggelassen wird)

HTTP-Server versuchen zuerst Streamable HTTP und greifen bei 4xx-Fehlern auf Legacy-SSE zurück (gemäß der MCP-Spezifikation). Du kannst auch \"transport\": \"sse\" explizit festlegen. Siehe MCP Configuration → Troubleshooting.

Beispiele:

# stdio-Server
devin mcp add my-server -- npx @company/mcp-server --port 3000

# HTTP-Server (positionale URL)
devin mcp add notion https://mcp.notion.com/mcp
devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

# HTTP-Server (--url-Flag, funktioniert auch)
devin mcp add notion --url https://mcp.notion.com/mcp

# Mit Umgebungsvariablen und Geltungsbereich
devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github
devin mcp add -s project sentry https://mcp.sentry.dev/mcp

Optionen für devin mcp remove:

-s, --scope <local|project|user> — Konfigurations-Geltungsbereich (Standard: local)

Optionen für devin mcp login:

--scopes <SCOPE,SCOPE> — Anzufordernde OAuth-Geltungsbereiche (kommagetrennt)
--oauth-resource <RESOURCE> — Überschreibt den in OAuth-Anfragen gesendeten RFC-8707-Parameter resource (Standard: die MCP-Server-URL; übergeben Sie eine leere Zeichenfolge, um ihn bei Anbietern wegzulassen, die ihn ablehnen)

Optionen für devin mcp enable:

-s, --scope <local|project|user> — Konfigurations-Geltungsbereich (Standard: local)

Optionen für devin mcp disable:

-s, --scope <local|project|user> — Konfigurations-Geltungsbereich (Standard: local)

Details finden Sie unter MCP-Konfiguration.

devin rules

Agent-Regeln verwalten (immer aktive Kontextblöcke).

Befehl	Beschreibung
`devin rules list`	Alle verfügbaren Regeln auflisten
`devin rules show <name>`	Details zu einer bestimmten Regel anzeigen
`devin rules paths`	Speicherorte der Regelverzeichnisse anzeigen

Optionen für devin rules list:

--provider <cursor\|windsurf> — Nach Regelanbieter filtern

Siehe Regeln für weitere Details.

devin skills

Agent-Skills verwalten (Slash-Befehle und vom Agenten ausgelöste Kontext-Blobs).

Befehl	Beschreibung
`devin skills list`	Alle verfügbaren Skills auflisten
`devin skills show <name>`	Details zu einem bestimmten Skill anzeigen
`devin skills paths`	Speicherorte der Skill-Verzeichnisse anzeigen

Optionen für devin skills list:

--trigger <user\|model> — Nach Triggertyp filtern

Weitere Informationen finden Sie unter Skills.

devin list

Listet die Sitzungen im aktuellen Verzeichnis auf. Alias: devin ls

Befehl	Beschreibung
`devin list`	Interaktive Sitzungsauswahl (Standard)
`devin list --format json`	Gibt Sitzungen als JSON aus
`devin list --format csv`	Gibt Sitzungen als CSV aus

devin version

Gibt die aktuelle Version aus und wird dann beendet.

devin version

Dies entspricht devin --version.

devin acp

Starte Devin über stdio als Agent Client Protocol (ACP)-Server. Dieser Unterbefehl ist dafür gedacht, von einem ACP-fähigen Editor oder einer IDE (wie Windsurf oder Zed) als Subprozess aufgerufen zu werden — er verwendet JSON-RPC über stdin/stdout und ist nicht für die interaktive Nutzung vorgesehen.

devin acp

Der ACP-Server liest Zugangsdaten aus WINDSURF_API_KEY, wenn diese Variable gesetzt ist, andernfalls aus den Zugangsdaten, die von devin auth login gespeichert wurden. Er kann Zugangsdaten auch zur Laufzeit über die ACP-Anfrage authenticate entgegennehmen.

devin update

Prüft, ob Updates verfügbar sind, und installiert sie bei Bedarf.

devin update

Verwenden Sie --force, um eine Neuinstallation zu erzwingen, selbst wenn bereits die neueste Version installiert ist:

devin update --force

devin shell

[Funktionsvorschau] Befehle für die Shell-Integration. Alle Details finden Sie unter Shell Integration.

Befehl	Beschreibung
`devin shell setup`	Die Shell-Integration in Ihrer Shell-Konfigurationsdatei installieren
`devin shell setup <shell>`	Für eine bestimmte Shell installieren (`bash`, `zsh` oder `fish`)

devin sandbox

[Technische Vorschau] Verwalten Sie die Prozess-Sandbox auf Betriebssystemebene für das Tool exec. Übergeben Sie das globale Flag --sandbox, um eine Sitzung mit aktivierter Sandbox zu starten.

devin sandbox setup

Gibt die Voraussetzungen für die Sandbox auf der aktuellen Plattform aus. Voraussetzungen für die Ausführung mit --sandbox:

Linux: Erfordert bubblewrap (bwrap) und socat. Eine Sandbox-Sitzung startet nicht und zeigt Installationsanweisungen an, wenn eines davon fehlt — auch in einer neuen WSL-Distribution.
macOS: Funktioniert sofort über Seatbelt; keine zusätzlichen Pakete erforderlich.
Windows: Unter nativem Windows kann die Sandbox nicht ausgeführt werden. Installieren Sie WSL 2 und führen Sie Devin in Ihrer WSL-Distribution aus.

devin sandbox setup

devin setup

Interaktiver Setup-Assistent für Authentifizierung und MCP-Konfiguration.

devin setup
devin setup --force-manual-token-flow  # Für Remote-/SSH-Sitzungen

devin uninstall

Deinstalliert die Devin CLI und entfernt bei Bedarf alle Daten.

Option	Beschreibung
`--clean`	Entfernt alle Daten einschließlich Konfiguration, Verlauf und benutzerdefinierter Daten
`--force`	Überspringt die Bestätigungsabfrage

Slash-Befehle

Diese Befehle sind in einer interaktiven Sitzung verfügbar. Geben Sie sie am Prompt ein.

Modus & Modell

Befehl	Beschreibung
`/mode [normal	accept-edits	plan	bypass]`	Den aktuellen Modus anzeigen oder wechseln (`autonomous` ist in Sandbox-Sitzungen verfügbar)
`/normal`	In den Normalmodus wechseln (Standard)
`/accept-edits`	In den Modus „Accept Edits“ wechseln (Dateiänderungen im Workspace automatisch genehmigen)
`/plan`	In den Plan-Modus wechseln (schreibgeschützte Planung)
`/ask <question>`	Eine Frage stellen, ohne Codeänderungen vorzunehmen (oneshot)
`/bypass`	In den Bypass-Modus wechseln (alle Aktionen automatisch genehmigen)
`/model [name]`	Das aktuelle Modell anzeigen oder ändern
`/fast`	Zu SWE-1.6 Fast wechseln
`/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]`	Zwischen Designs wechseln (dunkel, hell, Terminal dunkel, Terminal hell, ohne Farbe)

/bypass hat die Aliasnamen /yolo und /dangerous. Alle drei bewirken dasselbe.

Sitzungsverwaltung

Befehl	Beschreibung
`/clear`	Unterhaltungsverlauf löschen und eine neue Sitzung starten. Alias: `/new`
`/continue [session-id]`	Eine vorherige Sitzung fortsetzen
`/fork [step]`	Die aktuelle Sitzung in eine neue Sitzung verzweigen. Optional kann von einem bestimmten Schritt aus verzweigt werden (siehe `/steps`).
`/steps`	Schritte der Unterhaltung auflisten (zur Verwendung mit `/fork` und `/revert`)
`/revert <step>`	Dateiänderungen ab einem bestimmten Schritt rückgängig machen und die Unterhaltung auf den Stand vor diesem Schritt zurücksetzen
`/resume [session-id]`	Die interaktive Sitzungsauswahl öffnen oder eine bestimmte Sitzung anhand ihrer ID fortsetzen
`/ls [--all]`	Kürzlich verwendete Sitzungen auflisten (standardmäßig nur im aktuellen Verzeichnis). Alias: `/list-sessions`
`/rename-session <new title>`	Die aktuelle Sitzung umbenennen
`/rm-session <session-id>`	Eine Sitzung und alle zugehörigen Daten unwiderruflich löschen
`/export`	Exportinformationen anzeigen. Verwende zum Aktivieren des Unterhaltungs-Exports das CLI-Flag `--export`.
`/exit`	Die Anwendung beenden (Alias: `/quit`). Du kannst auch `exit` oder `quit` ohne das Präfix `/` eingeben.

Workspace

Befehl	Beschreibung
`/workspace`	Workspace-Verzeichnisse auflisten (Alias: `/workspaces`)
`/add-dir <path>`	Ein zusätzliches Workspace-Verzeichnis hinzufügen
`/undo-add-dir <path>`	Ein Workspace-Verzeichnis entfernen

Automatisierung

Befehl	Beschreibung
`/loop <prompt>`	Einen Prompt ausführen und anschließend das Diff in einer Schleife per Auto-Review prüfen
`/btw <prompt>`	Eine kurze Nebenfrage stellen. Führt eine Sidechain im Kontext der aktuellen Unterhaltung aus und gibt die Antwort in einem Kasten aus, ohne die Frage zur Hauptunterhaltung hinzuzufügen.

Erweiterbarkeit

Befehl	Beschreibung
`/hooks`	Listet alle geladenen Hooks mit ihren IDs, Ereignistypen und Quellpfaden auf

Dienstprogramme

Befehl	Beschreibung
`/help`	Verfügbare Slash-Befehle anzeigen
`/shortcuts`	Tastenkombinationen in einer interaktiven, durchsuchbaren und nach Kategorien gruppierten Liste anzeigen
`/bug [description]`	Einen Fehler an die Entwickler der Devin CLI melden
`/update [--force]`	Nach Updates suchen und sie installieren. Geben Sie `--force` an, um auch dann neu zu installieren, wenn bereits die neueste Version verwendet wird.
`/upgrade`	Ihren Abonnementplan aktualisieren
`/login`	Sich mit Ihrem Konto authentifizieren
`/logout`	Gespeicherte Anmeldedaten löschen und beenden
`/context`	Die Nutzung des Kontextfensters anzeigen
`/usage`	Die geschätzte Credit-/ACU-Nutzung für die Sitzung anzeigen, einschließlich der Nutzung aus früheren Öffnungen einer fortgesetzten Sitzung
`/compact`	Die Unterhaltung zwangsweise komprimieren

Cloud-Sitzungen (nur für Insider)

Befehl	Beschreibung
`/cloud-sessions [--all]`	Öffnet eine interaktive Auswahl Ihrer zuletzt verwendeten Cloud-Devin-Sitzungen. Navigieren Sie mit den Pfeiltasten, tippen Sie zum Filtern, drücken Sie die Eingabetaste zum Verbinden und Esc zum Abbrechen. Mit `--all` werden organisationsweite Sitzungen angezeigt.
`/cloud-attach <session-id>`	Stellt eine Verbindung zu einer Cloud-Devin-Sitzung mit vollständigem TUI-Rendering und bidirektionaler Eingabe her.

Modi

Modi steuern den Autonomiegrad des Agenten, indem sie einen Berechtigungsmodus mit einem Agentenprofil kombinieren.

Normal (Standard)
Plan
Bypass

Volle Autonomie für komplexe Programmieraufgaben. Der Agent kann mit normalen Berechtigungsprüfungen lesen, schreiben und Befehle ausführen.

Berechtigungsmodus: Normal
Profil: Normal
Verwenden für: Refactoring über mehrere Dateien, Feature-Implementierung, Fehlerbehebungen

Wechseln Sie mit /mode zwischen den Modi oder direkt mit /normal, /accept-edits, /plan oder /bypass. Verwenden Sie /ask <question> als Einmalbefehl, um Fragen zu stellen, ohne den Modus zu wechseln.

Profile

Profile bestimmen die verfügbaren Tools und das Verhalten des Agenten. Profile werden automatisch festgelegt, wenn Sie den Modus wechseln.

Profil	Beschreibung	Tool-Zugriff
`normal`	Vollwertiger Programmierassistent (verwendet von den Modi „Normal“, „Accept Edits“ und „Bypass“)	Alle Tools
`plan`	Strukturierter Planungs-Workflow (verwendet vom Plan-Modus)	schreibgeschützte Tools (grep, glob, read, todo, ask_user_question, exit_plan_mode)
`ask`	Beantwortung von Fragen (verwendet vom Befehl `/ask`)	schreibgeschützte Tools (grep, glob, read, todo, ask_user_question)

​Verwendung

​Globale Flags

​Unterbefehle

​devin auth

​devin mcp

​devin rules

​devin skills

​devin list

​devin version

​devin acp

​devin update

​devin shell

​devin sandbox

​devin sandbox setup

​devin setup

​devin uninstall

​Slash-Befehle

​Modus & Modell

​Sitzungsverwaltung

​Workspace

​Automatisierung

​Erweiterbarkeit

​Dienstprogramme

​Cloud-Sitzungen (nur für Insider)

​Modi

​Profile

Verwendung

Globale Flags

Unterbefehle

devin auth

devin mcp

devin rules

devin skills

devin list

devin version

devin acp

devin update

devin shell

devin sandbox

devin sandbox setup

devin setup

devin uninstall

Slash-Befehle

Modus & Modell

Sitzungsverwaltung

Workspace

Automatisierung

Erweiterbarkeit

Dienstprogramme

Cloud-Sitzungen (nur für Insider)

Modi

Profile