> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/es/guias/understand/how-it-works.md).

# Cómo funciona Devolutions CLI

Devolutions CLI sustituye los valores secretos por referencias devo y los resuelve desde su espacio de trabajo solo cuando se inicia un comando.

Devolutions CLI no almacena sus secretos. **Apunta a ellos**. Sus scripts, los archivos `.env` y las instrucciones del agente contienen una referencia `devo://`, y Devolutions CLI obtiene el valor de su espacio de trabajo solo en el momento en que un comando lo necesita. Entender esta sola idea explica casi todo lo demás: qué puede confirmar con seguridad, por qué inicia sesión una vez y qué comandos mantienen un secreto oculto.

## Cuatro bloques básicos

<table><thead><tr><th width="190">BLOQUE BÁSICO</th><th>QUÉ ES</th><th>EJEMPLO</th></tr></thead><tbody><tr><td><strong>Espacio de trabajo</strong></td><td>Donde viven sus secretos: Devolutions Cloud, Devolutions Server o un perfil local de Devolutions Remote Desktop Manager. Dentro, los secretos están en campos de entradas, agrupados en bóvedas.</td><td>El campo <code>password</code> de la entrada <em>Production database</em>, en la bóveda <em>Operations</em>.</td></tr><tr><td><strong>Contexto</strong></td><td>Una conexión guardada a un espacio de trabajo, con un nombre que usted elige. La crea una vez con <code>devo login</code>, y cada comando posterior usa el contexto actual.</td><td><code>my-cloud</code>, <code>work-server</code>, <code>my-local</code></td></tr><tr><td><strong>Referencia</strong></td><td>La dirección de un campo, que empieza por <code>devo://</code>. Dice dónde está el secreto, nunca qué es.</td><td><code>devo://&#x3C;workspace>/&#x3C;vault>/&#x3C;entry>/password</code></td></tr><tr><td><strong>Comando</strong></td><td>El programa que necesita el secreto. <code>devo secret run</code> resuelve las referencias, da los valores solo a ese programa y lo inicia.</td><td>Un script de implementación, un cliente de base de datos, un agente de IA.</td></tr></tbody></table>

## Qué significa esto para usted

**Las referencias se pueden compartir sin riesgo.** Una referencia contiene nombres o identificadores, no un valor. Puede incluirla en un commit, pegarla en un ticket o dársela a un agente de IA. Sin acceso a la bóveda, no abre nada. Consulte [Sintaxis de las referencias de secreto](/cli/es/referencia/secret-references.md).

**Inicia sesión una vez y después trabaja.** `devo login` guarda el contexto y lo hace actual, para que los comandos posteriores no vuelvan a preguntar. Para usar otro espacio de trabajo en un solo comando, añada `--context <name>`. Consulte [Cambiar entre espacios de trabajo](/cli/es/guias/connect/switch-workspaces.md).

**Los mismos comandos funcionan en todas partes.** Leer un secreto o ejecutar un comando se ve igual en Devolutions Cloud, Devolutions Server y un perfil local. Cuando un espacio de trabajo no puede hacer algo, el comando lo dice en lugar de fallar en silencio. Consulte [Comparar los tipos de espacio de trabajo](/cli/es/guias/understand/workspace-types.md).

**Un secreto llega solo al comando que usted inicia.** `devo secret run` coloca los valores en el entorno de ese único programa, no en su shell. Devolutions CLI rechaza las referencias escritas como argumentos del comando y oculta los valores resueltos en lo que el programa imprime. Consulte [Ejecutar un comando con sus secretos](/cli/es/guias/secrets/run-with-secrets.md).

**Algunos comandos entregan el valor a propósito.** Leer un secreto en el terminal, rellenar un archivo de plantilla, cargar secretos en su shell actual o dejar que un cliente de IA lea una entrada le da a usted, o al modelo, el valor real. Elija el comando que corresponda a cuánto quiere exponer. Consulte [Qué permanece oculto y qué no](/cli/es/guias/understand/security-model.md).

## El proceso en segundo plano

Para seguir siendo rápido, `devo` inicia un proceso en segundo plano la primera vez que un comando necesita su espacio de trabajo, y lo reutiliza después. Es el mismo archivo `devo` que se ejecuta en segundo plano, con su cuenta de usuario, y habla con `devo` por un canal local en su ordenador. No tiene que instalar un servicio ni iniciar nada usted mismo.

Si prefiere controlarlo, la opción `--daemon` acepta `auto` (el valor predeterminado: iniciarlo cuando haga falta), `require` (usar uno que ya está en ejecución) o `never`. Los comandos `devo daemon` muestran su estado, lo detienen o lo reinician. Consulte [El proceso en segundo plano no se inicia](/cli/es/ayuda/troubleshooting/daemon-wont-start.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/es/guias/understand/how-it-works.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.