# Het dvina-commando gebruiken

> Lees wat het dvina-commando doet wanneer Dvina code voor je uitvoert, welke commando's er zijn en welke om je goedkeuring vragen.

Wanneer Dvina code of commando's voor je uitvoert, beschikt het over een eigen commando: `dvina`. Daarmee kan een script of een reeks stappen namens jou in je Dvina zoeken, documenten, geheugen en taken lezen en toevoegen, en controleren wie toegang heeft tot een item.

Je hoeft niets te installeren of je ergens aan te melden. Dvina gebruikt het commando wanneer dat nodig is voor je verzoek. Je kunt er ook zelf om vragen, bijvoorbeeld: "Gebruik dvina om mijn taken op te sommen en een samenvatting als notitie te schrijven."

## Hoe het werkt

- `dvina` werkt in je eigen Dvina, namens jou, met de rechten van je rol en binnen je gebruikelijke limieten.
- Het heeft alleen toegang zolang Dvina aan je verzoek werkt. Zodra het antwoord is afgerond, heeft het commando geen toegang meer tot je Dvina.
- Het leest een bestand of map alleen als een commando die expliciet noemt, bijvoorbeeld een bestand om te uploaden.

## Commando's

Commando's zijn ingedeeld in groepen: `dvina <group> <command>`, gevolgd door de argumenten en opties van het commando.

| Groep      | Commando's                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: doorzoek je chats, documenten, geheugen en wereld tegelijk.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: bekijk een lijst van je geheugenbestanden, lees ze, voeg ze toe of wijzig ze.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: je onderwerpen, wat Dvina ergens over weet en je Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: de documenten en mappen in je Library. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: bekijk een lijst van canvaspagina's, lees ze, maak ze aan of herschrijf ze.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: je achtergrondtaken.                                                        |
| `goals`    | `show`, `start`: taken die naar een doel toewerken.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: geplande berichten en herinneringen, eenmalig of terugkerend.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: je agents.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: je skills.                                                                                |
| `projects` | `ls`, `show`: je projecten.                                                                                             |
| `settings` | `get`, `set`: je voorkeuren, zoals het in- of uitschakelen van geheugen.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: wie toegang heeft tot een item, wat anderen met je hebben gedeeld en toegang verlenen of intrekken.  |

`dvina` kan niets definitief verwijderen, openbare links openen, apps koppelen of ontkoppelen, of beheer- of factureringsinstellingen wijzigen.

### Hulp en uitvoer

- `dvina --help` toont de groepen, `dvina <group> --help` toont de commando's van een groep en `dvina <group> <command> --help` toont de argumenten en opties van een commando.
- De uitvoer is korte tekst. Voeg `--json` toe voor JSON, of `--fields` met een door komma's gescheiden lijst, zoals `--fields id,title`, om alleen bepaalde velden te behouden.
- Een lange lijst eindigt met `next: --cursor <c>`. Voer het commando opnieuw uit met die `--cursor` om de volgende pagina op te halen.
- Voeg `-file` toe aan de optie om een waarde uit een bestand te lezen, bijvoorbeeld `--content-file notes.md`. `dvina docs upload <file>` uploadt een bestand en `dvina skills add <folder>` voegt een skillmap toe met het bijbehorende SKILL.md.

### Exitcodes

| Code | Betekenis                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Klaar.                                                                         |
| `1`  | Er is iets anders misgegaan.                                                    |
| `2`  | Het commando is onjuist. Bekijk de bijbehorende `--help`.                                     |
| `3`  | Niet gevonden.                                                                    |
| `4`  | Geweigerd: je toegangsrechten, de regels van je bedrijf of de gegevensbescherming staan dit niet toe. |
| `5`  | Je goedkeuring is nodig.                                                       |
| `6`  | Je hebt je gebruikslimiet bereikt.                                              |

## Wijzigingen goedkeuren

- Commando's die gegevens lezen, worden uitgevoerd zonder je om toestemming te vragen.
- Commando's die iets nieuws toevoegen, zoals `docs create`, `memory add` of `tasks start`, worden uitgevoerd zonder je om toestemming te vragen. Ze wijzigen nooit wat er al is.
- Commando's die iets wijzigen of verwijderen, vragen je eerst om toestemming: verplaatsen, hernoemen, naar de prullenmand verplaatsen, een notitie of geheugenbestand vervangen, een canvaspagina herschrijven, een agent of skill wijzigen, een taak stoppen, een gepland bericht annuleren en delen. Dvina toont een goedkeuringskaart in de chat met een eigen samenvatting van de wijziging en vraagt elke keer om je goedkeuring. Als je die weigert, verandert er niets.

Alles wat `dvina` toevoegt of wijzigt, wordt getoetst aan de regels voor gegevensbescherming van je bedrijf en vastgelegd in je [auditlog](/docs/teams/audit-log), net als de andere acties van Dvina.

## Gerelateerd

- [Dvina vanuit andere apps gebruiken met MCP](/docs/dvina-mcp/overview)
- [Taken](/docs/use-dvina/features/tasks)
- [Overzicht van connectors](/docs/connectors/overview)