> ## 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.

# Utiliser l’Olostep CLI avec des agents IA

> Comment Claude Code, Cursor, Codex et d’autres agents de codage exécutent la commande olostep.

Les agents de codage IA peuvent exécuter `olostep` comme n'importe quelle autre commande. Le CLI détecte lorsqu'un agent de codage l'exécute et se comporte pour un programme au lieu d'une personne.

## Configuration

**1. Installe le CLI et connecte-toi**

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

L'agent utilise ta connexion sur cet ordinateur. En CI, configure `OLOSTEP_TOKEN` à la place. Voir [Authentification](https://docs.olostep.com/cli/authentication.md#scripts-ci-and-agents).

**2. Donne à l'agent le guide du CLI**

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

Cela écrit `.claude/skills/olostep-cli/SKILL.md` : comment exécuter le CLI, ses codes de sortie, et chaque commande avec ses options et le schéma de sortie JSON. Utilise le dossier de compétences de ton agent à la place de `.claude/skills`.

**3. Indique à l'agent d'utiliser --json**

Les agents devraient exécuter les commandes avec `--json` et lire le JSON. La sortie humaine est pour les personnes et peut changer.

## Comment le CLI se comporte pour un agent

Le CLI considère qu'une exécution est celle d'un agent lorsqu'il n'y a pas de terminal, ou lorsque l'un de `CLAUDECODE`, `CURSOR_AGENT`, `CODEX_CI` ou `AI_AGENT` est défini. Alors :

* `olostep` sans commande affiche l'aide, pas l'écran d'accueil.
* Il ne demande jamais de confirmation. Une commande nécessitant une connexion se termine avec le code `3` et indique à l'agent, sur stderr, d'exécuter `olostep login` ou de configurer `OLOSTEP_TOKEN`.
* Une commande pouvant supprimer ou écraser quelque chose se termine avec le code `4` sauf si tu passes `--yes`.
* `olostep keys reveal` n'affiche jamais une clé. Utilise `--write-env <file>` pour l'enregistrer dans un fichier d'environnement ignoré par git.
* `olostep chat` affiche les réponses en texte brut (`--plain` est activé), et nécessite un message.
* Aucun avis de mise à jour n'est imprimé.

| Code de sortie | Ce que l'agent doit faire |
| - | - |
| `0` | Lire la sortie. |
| `1` | Lire l'erreur sur stderr. |
| `2` | Vérifier la commande avec `olostep <command> --help`. |
| `3` | Demander à la personne d'exécuter `olostep login`. |
| `4` | Confirmer avec la personne, puis réexécuter avec `--yes`. |
| `5` | Le serveur n'a pas pu être atteint. Réessayer plus tard. |

## Trouver la bonne commande

```bash theme={null}
olostep help monitor pause        # commandes dont le nom ou la description contient chaque mot
olostep tools --search crawl      # outils qui mentionnent "crawl"
olostep tools crawl_create        # schéma complet d'entrée et de sortie d'un outil
```

## `olostep skill`

Les compétences sont de courtes instructions pour un type de tâche. Liste-les, lis-les, ou écris-les dans le dossier de compétences d'un agent :

```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
```

| Compétence | Ce qu'elle couvre |
| - | - |
| `olostep-cli` | Comment utiliser la ligne de commande `olostep`. Généré à partir des commandes du CLI. |
| `credit-usage` | Soldes de crédits, plans, expiration des crédits et utilisation quotidienne. |
| `dashboard` | Fonctionnalités du tableau de bord : compte, facturation, équipe, clés API, journaux, travaux, parseurs, moniteurs, agents, support et intégrations. |

`olostep skill list` affiche la liste actuelle. Voir [`olostep skill`](https://docs.olostep.com/cli/reference/cli-commands#olostep-skill) pour les options.

## `olostep tools`

Chaque commande CLI appelle un outil sur le serveur Olostep. `olostep tools` les liste, et marque ceux qui modifient des choses :

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

## Donner des retours

Lorsqu'une commande échoue, manque ou est confuse, l'agent peut en informer l'équipe Olostep. Cela fonctionne sans connexion :

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

Utilise `--about tooling` pour le CLI lui-même et `--about product` pour Olostep. Ne jamais inclure de clés, mots de passe ou détails personnels.

## MCP au lieu d'un terminal

Si ton agent prend en charge MCP, tu peux le connecter directement à Olostep. Voir [Serveur MCP](https://docs.olostep.com/integrations/mcp-server.md), ou imprimer la configuration pour ton 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.