# Använd kommandot dvina

> Lär dig vad kommandot dvina gör när Dvina kör kod åt dig, vilka kommandon som finns och vilka som kräver ditt godkännande.

När Dvina kör kod eller kommandon åt dig har det ett eget kommando: `dvina`. Med det kan ett skript eller några steg i följd söka i din Dvina, läsa och lägga till dokument, minne och uppgifter samt kontrollera vem som har åtkomst till ett objekt – i ditt namn.

Du behöver inte installera något eller logga in. Dvina använder kommandot när din begäran kräver det, och du kan själv be om det, till exempel: ”Använd dvina för att lista mina uppgifter och skriva en sammanfattning som en anteckning.”

## Så fungerar det

- `dvina` arbetar i din egen Dvina, i ditt namn, med de behörigheter din roll ger och inom dina vanliga gränser.
- Åtkomsten gäller bara medan Dvina arbetar med din begäran. När svaret är klart kan kommandot inte längre komma åt din Dvina.
- Det läser bara en fil eller mapp när ett kommando anger den, till exempel en fil som ska laddas upp.

## Kommandon

Kommandona är indelade i grupper: `dvina <group> <command>`, följt av kommandots argument och flaggor.

| Grupp      | Kommandon                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: sök i dina chattar, dokument, ditt minne och din värld samtidigt.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: lista, läs, lägg till eller ändra dina minnesfiler.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: dina ämnen, vad Dvina vet om något och ditt flöde.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: dokument och mappar i ditt bibliotek. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: lista, läs, skapa eller skriv om canvas-sidor.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: dina bakgrundsuppgifter.                                                        |
| `goals`    | `show`, `start`: uppgifter som arbetar mot ett mål.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: schemalagda meddelanden och påminnelser, en gång eller återkommande.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: dina agenter.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: dina färdigheter.                                                                                |
| `projects` | `ls`, `show`: dina projekt.                                                                                             |
| `settings` | `get`, `set`: dina inställningar, som att slå på eller av minnet.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: vem som har åtkomst till ett objekt, vad andra har delat med dig samt att ge eller ta bort åtkomst.  |

`dvina` kan inte radera något permanent, öppna offentliga länkar, ansluta eller koppla från appar eller ändra inställningar för administration eller fakturering.

### Hjälp och utdata

- `dvina --help` listar grupperna, `dvina <group> --help` listar en grupps kommandon och `dvina <group> <command> --help` listar ett kommandos argument och flaggor.
- Utdata är kortfattad text. Lägg till `--json` för JSON, eller `--fields` med en kommaseparerad lista, till exempel `--fields id,title`, för att bara behålla vissa fält.
- En lång lista avslutas med `next: --cursor <c>`. Kör kommandot igen med denna `--cursor` för att få nästa sida.
- För att läsa ett värde från en fil lägger du till `-file` i dess flagga, till exempel `--content-file notes.md`. `dvina docs upload <file>` laddar upp en fil och `dvina skills add <folder>` lägger till en färdighetsmapp med dess SKILL.md.

### Avslutningskoder

| Kod | Betydelse                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Klart.                                                                         |
| `1`  | Något annat gick fel.                                                    |
| `2`  | Kommandot är felaktigt. Kontrollera dess `--help`.                                     |
| `3`  | Hittades inte.                                                                    |
| `4`  | Nekat: din åtkomst, företagets regler eller dataskyddet tillåter det inte. |
| `5`  | Ditt godkännande behövs.                                                       |
| `6`  | Du har nått din användningsgräns.                                              |

## Godkänn ändringar

- Kommandon som läser körs utan att fråga.
- Kommandon som lägger till något nytt, som `docs create`, `memory add` eller `tasks start`, körs utan att fråga. De ändrar aldrig det som redan finns.
- Kommandon som ändrar eller tar bort något frågar dig först: att flytta, byta namn, flytta till papperskorgen, ersätta en anteckning eller minnesfil, skriva om en canvas-sida, ändra en agent eller färdighet, stoppa en uppgift, avbryta ett schemalagt meddelande och dela. Dvina visar ett godkännandekort i chatten med sin egen sammanfattning av ändringen och frågar varje gång. Om du nekar ändras ingenting.

Det som `dvina` lägger till eller ändrar kontrolleras mot företagets dataskyddsregler och registreras i din [granskningslogg](/docs/teams/audit-log), precis som Dvinas övriga åtgärder.

## Relaterat

- [Använd Dvina från andra appar med MCP](/docs/dvina-mcp/overview)
- [Uppgifter](/docs/use-dvina/features/tasks)
- [Översikt över anslutningar](/docs/connectors/overview)
