> ## 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 la CLI di Olostep con agenti AI

> Come Claude Code, Cursor, Codex e altri agenti di codifica eseguono il comando olostep.

Gli agenti di codifica AI possono eseguire `olostep` come qualsiasi altro comando. La CLI riconosce quando un agente di codifica lo esegue e si comporta per un programma invece che per una persona.

## Configuralo

**1. Installa la CLI ed effettua l'accesso**

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

L'agente utilizza il tuo accesso su questo computer. In CI, imposta `OLOSTEP_TOKEN` invece. Vedi [Autenticazione](https://docs.olostep.com/cli/authentication.md#scripts-ci-and-agents).

**2. Fornisci all'agente la guida CLI**

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

Questo scrive `.claude/skills/olostep-cli/SKILL.md`: come eseguire la CLI, i suoi codici di uscita e ogni comando con le sue opzioni e lo schema di output JSON. Usa la cartella delle abilità del tuo agente al posto di `.claude/skills`.

**3. Indica all'agente di usare --json**

Gli agenti dovrebbero eseguire i comandi con `--json` e leggere il JSON. L'output umano è per le persone e può cambiare.

## Come si comporta la CLI per un agente

La CLI tratta un'esecuzione come quella di un agente quando non c'è un terminale, o quando uno dei `CLAUDECODE`, `CURSOR_AGENT`, `CODEX_CI` o `AI_AGENT` è impostato. Quindi:

* `olostep` senza comando stampa l'aiuto, non la schermata di benvenuto.
* Non richiede mai input. Un comando che necessita di accesso esce con codice `3` e informa l'agente, su stderr, di eseguire `olostep login` o impostare `OLOSTEP_TOKEN`.
* Un comando che potrebbe cancellare o sovrascrivere qualcosa esce con codice `4` a meno che non passi `--yes`.
* `olostep keys reveal` non stampa mai una chiave. Usa `--write-env <file>` per salvarla in un file env ignorato da git.
* `olostep chat` stampa le risposte come testo semplice (`--plain` è attivo) e necessita di un messaggio.
* Nessun avviso di aggiornamento viene stampato.

| Codice di uscita | Cosa dovrebbe fare l'agente |
| - | - |
| `0` | Leggi l'output. |
| `1` | Leggi l'errore su stderr. |
| `2` | Controlla il comando con `olostep <command> --help`. |
| `3` | Chiedi alla persona di eseguire `olostep login`. |
| `4` | Conferma con la persona, poi esegui di nuovo con `--yes`. |
| `5` | Il server non può essere raggiunto. Riprova più tardi. |

## Trova il comando giusto

```bash theme={null}
olostep help monitor pause        # comandi il cui nome o descrizione contiene ogni parola
olostep tools --search crawl      # strumenti che menzionano "crawl"
olostep tools crawl_create        # schema completo di input e output di uno strumento
```

## `olostep skill`

Le abilità sono brevi istruzioni per un tipo di compito. Elencale, leggile o scrivile nella cartella delle abilità di 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
```

| Abilità | Cosa copre |
| - | - |
| `olostep-cli` | Come usare la riga di comando `olostep`. Generato dai comandi della CLI. |
| `credit-usage` | Saldi dei crediti, piani, scadenza dei crediti e utilizzo giornaliero. |
| `dashboard` | Funzionalità del dashboard: account, fatturazione, team, chiavi API, log, lavori, parser, monitor, agenti, supporto e integrazioni. |

`olostep skill list` mostra l'elenco corrente. Vedi [`olostep skill`](https://docs.olostep.com/cli/reference/cli-commands#olostep-skill) per le opzioni.

## `olostep tools`

Ogni comando CLI chiama uno strumento sul server Olostep. `olostep tools` li elenca e segna quelli che modificano le cose:

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

## Fornisci feedback

Quando un comando fallisce, manca o è confuso, l'agente può informare il team di Olostep. Questo funziona senza effettuare l'accesso:

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

Usa `--about tooling` per la CLI stessa e `--about product` per Olostep. Non includere mai chiavi, password o dettagli personali.

## MCP invece di un terminale

Se il tuo agente supporta MCP, puoi connetterlo direttamente a Olostep. Vedi [server MCP](https://docs.olostep.com/integrations/mcp-server.md), o stampa la configurazione per il tuo client:

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


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