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

# Befehle & Flags

> Vollständige Referenz für Befehlsargumente, Unterbefehle und interaktive Slash-Befehle

<div id="usage">
  ## Verwendung
</div>

```bash theme={null}
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.

***

<div id="global-flags">
  ## Globale Flags
</div>

| 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:**

```bash theme={null}
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
```

***

<div id="subcommands">
  ## Unterbefehle
</div>

<div id="devin-auth">
  ### devin auth
</div>

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)

<div id="devin-mcp">
  ### devin mcp
</div>

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)
* `<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)

<Note>
  HTTP-Server versuchen zuerst Streamable HTTP und greifen bei 4xx-Fehlern auf Legacy-SSE zurück (gemäß der [MCP-Spezifikation](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). Du kannst auch `\"transport\": \"sse\"` explizit festlegen. Siehe [MCP Configuration → Troubleshooting](/de/cli/extensibility/mcp/configuration#troubleshooting).
</Note>

**Beispiele:**

```bash theme={null}
# 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)

**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](/de/cli/extensibility/mcp/configuration).

<div id="devin-rules">
  ### devin rules
</div>

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](/de/cli/extensibility/rules) für weitere Details.

<div id="devin-skills">
  ### devin skills
</div>

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](/de/cli/extensibility/skills/overview).

<div id="devin-list">
  ### devin list
</div>

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             |

<div id="devin-version">
  ### devin version
</div>

Gibt die aktuelle Version aus und wird dann beendet.

```bash theme={null}
devin version
```

Dies entspricht `devin --version`.

<div id="devin-acp">
  ### devin acp
</div>

Starte Devin über stdio als [Agent Client Protocol (ACP)](https://agentclientprotocol.com/)-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.

```bash theme={null}
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.

<div id="devin-update">
  ### devin update
</div>

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

```bash theme={null}
devin update
```

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

```bash theme={null}
devin update --force
```

<div id="devin-shell">
  ### devin shell
</div>

\[Funktionsvorschau] Befehle für die Shell-Integration. Alle Details finden Sie unter [Shell Integration](/de/cli/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`)     |

<div id="devin-sandbox">
  ### devin sandbox
</div>

\[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.

<div id="devin-sandbox-setup">
  #### devin sandbox setup
</div>

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](https://learn.microsoft.com/windows/wsl/install) und führen Sie Devin in Ihrer WSL-Distribution aus.

```bash theme={null}
devin sandbox setup
```

<div id="devin-setup">
  ### devin setup
</div>

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

```bash theme={null}
devin setup
devin setup --force-manual-token-flow  # Für Remote-/SSH-Sitzungen
```

<div id="devin-uninstall">
  ### devin uninstall
</div>

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                                                     |

***

<div id="slash-commands">
  ## Slash-Befehle
</div>

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

<div id="mode-model">
  ### Modus & Modell
</div>

| 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)       |      |           |                                                                                              |

<Note>
  `/bypass` hat die Aliasnamen `/yolo` und `/dangerous`. Alle drei bewirken dasselbe.
</Note>

<div id="session-management">
  ### Sitzungsverwaltung
</div>

| 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.                                 |

<div id="workspace">
  ### Workspace
</div>

| 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                      |

<div id="automation">
  ### Automatisierung
</div>

| 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. |

<div id="extensibility">
  ### Erweiterbarkeit
</div>

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

<div id="utilities">
  ### Dienstprogramme
</div>

| 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                                                                                                            |

<div id="cloud-sessions-insiders-only">
  ### Cloud-Sitzungen (nur für Insider)
</div>

| 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.                                                                                                                                                      |

***

<div id="modes">
  ## Modi
</div>

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

<Tabs>
  <Tab title="Normal (Standard)">
    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
  </Tab>

  <Tab title="Plan">
    Nur Planung — der Agent schlägt Änderungen vor, ohne sie vorzunehmen. Der schreibgeschützte Zugriff auf Tools stellt sicher, dass kein Code geändert wird.

    * **Berechtigungsmodus:** Normal
    * **Profil:** Plan (schreibgeschützte Tools)
    * **Verwenden für:** Architekturdesign, Verständnis von Codebasen, Planung vor der Implementierung
  </Tab>

  <Tab title="Bypass">
    Alle Berechtigungsabfragen werden automatisch genehmigt. Der Agent führt Befehle frei aus, ohne um Bestätigung zu bitten.

    * **Berechtigungsmodus:** Dangerous
    * **Profil:** Normal
    * **Verwenden für:** Vertrauenswürdige Aufgaben, bei denen Unterbrechungen Sie ausbremsen

    <Warning>
      Verwenden Sie den Bypass-Modus nur für Aufgaben, denen Sie vollständig vertrauen. Alle Tool-Aufrufe (einschließlich destruktiver Befehle) werden automatisch genehmigt.
    </Warning>
  </Tab>
</Tabs>

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.

***

<div id="profiles">
  ## Profile
</div>

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)                   |
