# Den dvina-Befehl verwenden

> Erfahre, was der dvina-Befehl macht, wenn Dvina Code für dich ausführt, welche Befehle verfügbar sind und welche deine Zustimmung erfordern.

Wenn Dvina Code oder Befehle für dich ausführt, steht dafür ein eigener Befehl zur Verfügung: `dvina`. Damit kann ein Skript oder eine Folge von Schritten dein Dvina durchsuchen, Dokumente, Erinnerungen und Aufgaben lesen und hinzufügen sowie prüfen, wer Zugriff auf ein Element hat – alles in deinem Namen.

Du musst nichts installieren und dich nirgends anmelden. Dvina verwendet den Befehl, wenn deine Anfrage es erfordert. Du kannst auch ausdrücklich darum bitten, etwa: „Verwende dvina, um meine Aufgaben aufzulisten und eine Zusammenfassung als Notiz zu schreiben.“

## So funktioniert es

- `dvina` arbeitet in deinem eigenen Dvina, in deinem Namen, mit den Berechtigungen deiner Rolle und innerhalb deiner üblichen Limits.
- Der Zugriff besteht nur, solange Dvina deine Anfrage bearbeitet. Sobald die Antwort abgeschlossen ist, kann der Befehl nicht mehr auf dein Dvina zugreifen.
- Eine Datei oder ein Ordner wird nur gelesen, wenn ein Befehl sie oder ihn ausdrücklich nennt, etwa eine Datei zum Hochladen.

## Befehle

Befehle sind in Gruppen gegliedert: `dvina <group> <command>`, gefolgt von den Argumenten und Optionen des Befehls.

| Gruppe     | Befehle                                                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: durchsucht deine Chats, Dokumente, Erinnerungen und Welt gleichzeitig.                            |
| `memory`   | `ls`, `show`, `add`, `edit`: deine Erinnerungsdateien auflisten, lesen, hinzufügen oder ändern.                           |
| `world`    | `topics`, `topic`, `recall`, `feed`: deine Themen, was Dvina über etwas weiß, und dein Feed.                              |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: Dokumente und Ordner deiner Bibliothek. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: Canvas-Seiten auflisten, lesen, erstellen oder neu schreiben.                       |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: deine Hintergrundaufgaben.                                                     |
| `goals`    | `show`, `start`: Aufgaben, die auf ein Ziel hinarbeiten.                                                                 |
| `schedule` | `ls`, `add`, `cancel`: geplante Nachrichten und Erinnerungen, einmalig oder wiederkehrend.                               |
| `agents`   | `ls`, `show`, `create`, `update`: deine Agenten.                                                                         |
| `skills`   | `ls`, `show`, `add`, `edit`: deine Skills.                                                                               |
| `projects` | `ls`, `show`: deine Projekte.                                                                                           |
| `settings` | `get`, `set`: deine Einstellungen, etwa das Ein- oder Ausschalten der Erinnerungsfunktion.                              |
| `share`    | `state`, `with-me`, `add`, `rm`: wer Zugriff auf ein Element hat, was andere mit dir geteilt haben, und Zugriff gewähren oder entziehen. |

`dvina` kann nichts endgültig löschen, keine öffentlichen Links öffnen, keine Apps verbinden oder trennen und keine Verwaltungs- oder Abrechnungseinstellungen ändern.

### Hilfe und Ausgabe

- `dvina --help` listet die Gruppen auf, `dvina <group> --help` die Befehle einer Gruppe und `dvina <group> <command> --help` die Argumente und Optionen eines Befehls.
- Die Ausgabe ist kurzer Text. Füge `--json` für JSON hinzu oder `--fields` mit einer kommagetrennten Liste, etwa `--fields id,title`, um nur bestimmte Felder auszugeben.
- Eine lange Liste endet mit `next: --cursor <c>`. Führe den Befehl erneut mit diesem `--cursor` aus, um die nächste Seite abzurufen.
- Um einen Wert aus einer Datei zu lesen, ergänze die zugehörige Option um `-file`, etwa `--content-file notes.md`. `dvina docs upload <file>` lädt eine Datei hoch, und `dvina skills add <folder>` fügt einen Skill-Ordner mit seiner SKILL.md hinzu.

### Exit-Codes

| Code | Bedeutung                                                                     |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Erledigt.                                                                     |
| `1`  | Ein anderer Fehler ist aufgetreten.                                           |
| `2`  | Der Befehl ist falsch. Prüfe seine `--help`-Ausgabe.                            |
| `3`  | Nicht gefunden.                                                               |
| `4`  | Abgelehnt: Deine Zugriffsrechte, die Regeln deines Unternehmens oder der Datenschutz lassen es nicht zu. |
| `5`  | Deine Zustimmung ist erforderlich.                                            |
| `6`  | Du hast dein Nutzungslimit erreicht.                                          |

## Änderungen genehmigen

- Befehle, die Daten lesen, werden ohne Rückfrage ausgeführt.
- Befehle, die etwas Neues hinzufügen, etwa `docs create`, `memory add` oder `tasks start`, werden ohne Rückfrage ausgeführt. Sie ändern niemals bereits vorhandene Inhalte.
- Befehle, die etwas ändern oder entfernen, fragen dich zuerst: Verschieben, Umbenennen, in den Papierkorb verschieben, eine Notiz oder Erinnerungsdatei ersetzen, eine Canvas-Seite neu schreiben, einen Agenten oder Skill ändern, eine Aufgabe stoppen, eine geplante Nachricht stornieren und Teilen. Dvina zeigt im Chat eine Genehmigungskarte mit einer eigenen Zusammenfassung der Änderung und fragt jedes Mal nach. Wenn du ablehnst, ändert sich nichts.

Was `dvina` hinzufügt oder ändert, wird nach den Datenschutzregeln deines Unternehmens geprüft und in deinem [Audit-Log](/docs/teams/audit-log) erfasst, genau wie die anderen Aktionen von Dvina.

## Verwandte Themen

- [Dvina über MCP aus anderen Apps verwenden](/docs/dvina-mcp/overview)
- [Aufgaben](/docs/use-dvina/features/tasks)
- [Übersicht der Konnektoren](/docs/connectors/overview)