> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usa el CLI de Olostep con agentes de IA

> Cómo Claude Code, Cursor, Codex y otros agentes de codificación ejecutan el comando olostep.

Los agentes de codificación de IA pueden ejecutar `olostep` como cualquier otro comando. El CLI detecta cuando un agente de codificación lo ejecuta y se comporta como para un programa en lugar de una persona.

## Configúralo

**1. Instala el CLI e inicia sesión tú mismo**

```bash theme={null}
curl -fsSL https://cli.olostep.com | sh
olostep login
```

El agente utiliza tu inicio de sesión en este ordenador. En CI, configura `OLOSTEP_TOKEN` en su lugar. Consulta [Autenticación](https://docs.olostep.com/cli/authentication.md#scripts-ci-and-agents).

**2. Dale al agente la guía del CLI**

```bash theme={null}
olostep skill get olostep-cli --write .claude/skills
```

Esto escribe `.claude/skills/olostep-cli/SKILL.md`: cómo ejecutar el CLI, sus códigos de salida y cada comando con sus banderas y esquema de salida JSON. Usa la carpeta de habilidades de tu agente en lugar de `.claude/skills`.

**3. Indica al agente que use --json**

Los agentes deben ejecutar comandos con `--json` y leer el JSON. La salida para humanos es para personas y puede cambiar.

## Cómo se comporta el CLI para un agente

El CLI trata una ejecución como de un agente cuando no hay terminal, o cuando se configura uno de `CLAUDECODE`, `CURSOR_AGENT`, `CODEX_CI` o `AI_AGENT`. Entonces:

* `olostep` sin comando imprime ayuda, no la pantalla de bienvenida.
* Nunca solicita. Un comando que necesita inicio de sesión sale con el código `3` y le dice al agente, en stderr, que ejecute `olostep login` o configure `OLOSTEP_TOKEN`.
* Un comando que puede eliminar o sobrescribir algo sale con el código `4` a menos que pases `--yes`.
* `olostep keys reveal` nunca imprime una clave. Usa `--write-env <file>` para guardarla en un archivo de entorno ignorado por git.
* `olostep chat` imprime respuestas como texto plano (`--plain` está activado), y necesita un mensaje.
* No se imprime aviso de actualización.

| Código de salida | Qué debe hacer el agente |
| - | - |
| `0` | Leer la salida. |
| `1` | Leer el error en stderr. |
| `2` | Verificar el comando con `olostep <command> --help`. |
| `3` | Pedir a la persona que ejecute `olostep login`. |
| `4` | Confirmar con la persona, luego ejecutar de nuevo con `--yes`. |
| `5` | No se pudo alcanzar el servidor. Intentar más tarde. |

## Encuentra el comando correcto

```bash theme={null}
olostep help monitor pause        # comandos cuyo nombre o descripción contiene cada palabra
olostep tools --search crawl      # herramientas que mencionan "crawl"
olostep tools crawl_create        # esquema completo de entrada y salida de una herramienta
```

## `olostep skill`

Las habilidades son instrucciones breves para un tipo de tarea. Listarlas, leerlas o escribirlas en la carpeta de habilidades de un agente:

```bash theme={null}
olostep skill list
olostep skill get credit-usage
olostep skill get olostep-cli dashboard --write .claude/skills
olostep skill get olostep-cli --json
```

| Habilidad | Qué cubre |
| - | - |
| `olostep-cli` | Cómo usar la línea de comandos `olostep`. Generado a partir de los comandos del CLI. |
| `credit-usage` | Saldos de crédito, planes, vencimiento de crédito y uso diario. |
| `dashboard` | Funciones del panel: cuenta, facturación, equipo, claves API, registros, trabajos, analizadores, monitores, agentes, soporte e integraciones. |

`olostep skill list` muestra la lista actual. Consulta [`olostep skill`](https://docs.olostep.com/cli/reference/cli-commands#olostep-skill) para las banderas.

## `olostep tools`

Cada comando del CLI llama a una herramienta en el servidor de Olostep. `olostep tools` las lista y marca las que cambian cosas:

```bash theme={null}
olostep tools
olostep tools --json
```

## Da tu opinión

Cuando un comando falla, falta o es confuso, el agente puede informar al equipo de Olostep. Esto funciona sin iniciar sesión:

```bash theme={null}
olostep feedback --about tooling --message "crawl create rejected --depth 0"
```

Usa `--about tooling` para el propio CLI y `--about product` para Olostep. Nunca incluyas claves, contraseñas o detalles personales.

## MCP en lugar de un terminal

Si tu agente admite MCP, puedes conectarlo directamente a Olostep. Consulta [Servidor MCP](https://docs.olostep.com/integrations/mcp-server.md), o imprime la configuración para tu cliente:

```bash theme={null}
olostep integrations config --client claude_code
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.