# Usa el comando dvina

> Descubre qué hace el comando dvina cuando Dvina ejecuta código por ti, qué comandos incluye y cuáles te piden aprobación.

Cuando Dvina ejecuta código o comandos por ti, dispone de un comando propio: `dvina`. Con él, un script o una secuencia de pasos puede buscar en tu Dvina, leer y añadir documentos, memoria y tareas, y comprobar quién tiene acceso a un elemento, actuando en tu nombre.

No tienes que instalar nada ni iniciar sesión. Dvina usa el comando cuando tu solicitud lo requiere, y también puedes pedírselo, por ejemplo: "Usa dvina para listar mis tareas y escribir un resumen como nota".

## Cómo funciona

- `dvina` actúa en tu propio Dvina, en tu nombre, con los permisos de tu rol y dentro de tus límites habituales.
- Su acceso dura solo mientras Dvina trabaja en tu solicitud. Cuando termina la respuesta, el comando ya no puede acceder a tu Dvina.
- Solo lee un archivo o una carpeta cuando un comando lo especifica, como un archivo que se va a subir.

## Comandos

Los comandos se organizan en grupos: `dvina <group> <command>`, seguido de los argumentos y las opciones del comando.

| Grupo      | Comandos                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: busca en tus chats, documentos, memoria y mundo a la vez.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: lista, lee, añade o modifica tus archivos de memoria.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: tus temas, lo que Dvina sabe sobre algo y tu Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: los documentos y las carpetas de tu Biblioteca. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: lista, lee, crea o reescribe páginas de canvas.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: tus tareas en segundo plano.                                                        |
| `goals`    | `show`, `start`: tareas que trabajan para alcanzar un objetivo.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: mensajes y recordatorios programados, únicos o recurrentes.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: tus agentes.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: tus habilidades.                                                                                |
| `projects` | `ls`, `show`: tus proyectos.                                                                                             |
| `settings` | `get`, `set`: tus preferencias, como activar o desactivar la memoria.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: quién tiene acceso a un elemento, qué han compartido otros contigo y cómo conceder o retirar el acceso.  |

`dvina` no puede eliminar nada de forma permanente, abrir enlaces públicos, conectar o desconectar aplicaciones, ni cambiar la configuración de administración o facturación.

### Ayuda y resultados

- `dvina --help` muestra los grupos, `dvina <group> --help` muestra los comandos de un grupo y `dvina <group> <command> --help` muestra los argumentos y las opciones de un comando.
- Los resultados se muestran como texto breve. Añade `--json` para obtener JSON, o `--fields` con una lista separada por comas, como `--fields id,title`, para conservar solo algunos campos.
- Una lista larga termina con `next: --cursor <c>`. Vuelve a ejecutar el comando con ese `--cursor` para obtener la siguiente página.
- Para leer un valor de un archivo, añade `-file` a su opción, como en `--content-file notes.md`. `dvina docs upload <file>` sube un archivo y `dvina skills add <folder>` añade una carpeta de habilidad con su SKILL.md.

### Códigos de salida

| Código | Significado                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Completado.                                                                         |
| `1`  | Se ha producido otro error.                                                    |
| `2`  | El comando es incorrecto. Consulta su `--help`.                                     |
| `3`  | No se ha encontrado.                                                                    |
| `4`  | Denegado: tus permisos de acceso, las normas de tu empresa o la protección de datos no lo permiten. |
| `5`  | Necesita tu aprobación.                                                       |
| `6`  | Has alcanzado tu límite de uso.                                              |

## Aprueba los cambios

- Los comandos de lectura se ejecutan sin pedirte aprobación.
- Los comandos que añaden algo nuevo, como `docs create`, `memory add` o `tasks start`, se ejecutan sin pedirte aprobación. Nunca modifican lo que ya existe.
- Los comandos que modifican o eliminan algo te piden aprobación primero: mover, cambiar de nombre, mover a la papelera, reemplazar una nota o un archivo de memoria, reescribir una página de canvas, modificar un agente o una habilidad, detener una tarea, cancelar un mensaje programado y compartir. Dvina muestra una tarjeta de aprobación en el chat con su propio resumen del cambio y te pide aprobación cada vez. Si lo rechazas, no cambia nada.

Todo lo que `dvina` añade o modifica pasa por las normas de protección de datos de tu empresa y queda registrado en tu [registro de auditoría](/docs/teams/audit-log), igual que las demás acciones de Dvina.

## Contenido relacionado

- [Usa Dvina desde otras aplicaciones con MCP](/docs/dvina-mcp/overview)
- [Tareas](/docs/use-dvina/features/tasks)
- [Descripción general de los conectores](/docs/connectors/overview)