# Grok CLI

Agent en terminal. Fiche relevée le 3 octobre 2026 sur les pages officielles. Page : https://quelleia.com/outils/grok-cli/

## En bref

Grok CLI est un agent de code open source pour le terminal, édité par la société Superagent et sans lien officiel avec xAI. Le dépôt précise qu'il n'est ni affilié à xAI ni soutenu par elle. Avec une clé d'API xAI, il lit et modifie les fichiers, lance des commandes, cherche sur le web et sur X. Il se pilote aussi depuis Telegram. L'outil officiel de xAI, Grok Build, se lance avec la même commande `grok`.

- Éditeur : Superagent (Superagent Technologies Inc.), États-Unis
- Prix : gratuit, à l'usage
- Licence : open source (MIT)
- Systèmes : macOS, Linux, Windows
- Formes : ligne de commande, pilotable depuis un téléphone
- Site officiel : https://www.superagent.sh

## Installer

Une des commandes télécharge un script et l'exécute tout de suite (`curl … | sh` ou équivalent). Lisez-le d'abord si vous voulez savoir ce qu'il fait.

### Tous systèmes (script d'installation)

```
curl -fsSL https://raw.githubusercontent.com/superagent-ai/grok-cli/main/install.sh | bash
```

### Tous systèmes (avec Bun déjà installé)

```
bun add -g grok-dev
```

### Tous systèmes (clé d'API)

Obtenir une clé d'API Grok sur x.ai, puis la placer au choix dans la variable GROK_API_KEY, dans un fichier .env du projet, avec `grok -k` ou dans ~/.grok/user-settings.json.

### Démarrer

Lancer `grok` pour ouvrir l'interface dans le terminal. L'option `-d` choisit le dossier du projet. Avec `--prompt` (`-p`), l'agent traite une seule consigne sans interface, pour un script ou l'intégration continue.
```
grok
```
```
grok -d /path/to/your/repo
```
```
grok --prompt "run the test suite and summarize failures"
```

### Choisir le modèle

`grok models` affiche les modèles Grok avec des indications de prix. L'option `-m` (ou `--model`) choisit le modèle au lancement. La variable GROK_MODEL et le fichier .grok/settings.json du projet le fixent aussi.
```
grok models
```
```
grok -m <model>
```

Source : https://github.com/superagent-ai/grok-cli#install (lue le 3 octobre 2026).

## Ce qu'il sait faire

- **Sous-agents** : L'agent confie par défaut des tâches à des sous-agents (exploration, général, ordinateur), au premier plan ou en arrière-plan. On peut aussi définir les siens. (https://github.com/superagent-ai/grok-cli#what-you-actually-get)
- **Recherche web et X** : Deux outils, search_web et search_x, vont chercher des pages web et des publications récentes sur X. (https://github.com/superagent-ai/grok-cli#what-you-actually-get)
- **Vérification** : `/verify` ou `--verify` construit l'application, lance les tests, la démarre dans un bac à sable et rend un rapport avec captures d'écran et vidéo. (https://github.com/superagent-ai/grok-cli#verify)
- **Tâches programmées** : Une consigne peut tourner une fois ou à intervalle régulier. Les tâches récurrentes demandent de lancer le service de fond avec `grok daemon --background`. (https://github.com/superagent-ai/grok-cli#scheduling)
- **Bac à sable** : L'option `--sandbox` exécute les commandes dans une micro-VM Shuru (une petite machine virtuelle), sans réseau par défaut. Elle demande macOS 14 ou plus sur puce Apple. (https://github.com/superagent-ai/grok-cli#sandbox)
- **Pilotage de l'ordinateur** : Un sous-agent « computer » manipule les applications du Mac en passant par les fonctions d'accessibilité (agent-desktop). Il ne fonctionne que sur macOS. (https://github.com/superagent-ai/grok-cli#computer-sub-agent)
- **MCP, skills et hooks** : L'agent accepte les serveurs MCP (le protocole standard pour brancher des outils et des sources de données à un agent). Il lit aussi les skills (procédures réutilisables) au format SKILL.md et les fichiers AGENTS.md. Des hooks lancent des commandes à chaque étape de l'agent. (https://github.com/superagent-ai/grok-cli#what-you-actually-get)
- **Images et vidéos** : Des outils créent des images et de courtes vidéos par l'API xAI. Les fichiers sont enregistrés dans .grok/generated-media/. (https://github.com/superagent-ai/grok-cli#run-it)

Les façons de l'utiliser :

- Ligne de commande : interface plein écran dans le terminal (OpenTUI) et mode sans interface `--prompt`, avec une sortie en texte ou en JSON (https://github.com/superagent-ai/grok-cli)

Systèmes :

- macOS : binaire pour puce Apple (darwin-arm64) seulement ; bac à sable sur macOS 14 ou plus
- Linux : binaire x64
- Windows : binaire x64 (.exe) publié avec chaque version ; le README ne décrit pas l'installation sous Windows

## Sur téléphone

- Telegram (bot créé par l'utilisateur) : Après un appairage par un code à six caractères, on envoie ses consignes à l'agent depuis Telegram, y compris par message vocal, transcrit par l'API de xAI. Grok CLI doit rester lancé sur l'ordinateur ; `grok telegram-bridge` le garde actif sans interface. (https://github.com/superagent-ai/grok-cli#telegram-remote-control--short-version)

## Prix et licence

L'outil est gratuit et open source. Il faut une clé d'API xAI : xAI facture les appels au modèle à l'usage. L'option `--batch-api` passe par l'API Batch de xAI, annoncée moins chère pour les tâches sans surveillance. Le dépôt ne cite aucun abonnement Grok ni SuperGrok. (relevé le 3 octobre 2026, https://github.com/superagent-ai/grok-cli#api-key-pick-one)

Licence : Open source, licence MIT. (https://github.com/superagent-ai/grok-cli/blob/main/LICENSE)

## Modèles

Seuls les modèles de l'API xAI sont prévus, avec une clé d'API personnelle. L'adresse de l'API se change par GROK_BASE_URL ou `-u` (par défaut https://api.x.ai/v1). Le README ne cite aucun autre fournisseur ni modèle local.

- Clé d'API personnelle : oui
- Modèles locaux : non établi

## Résultats mesurés

Comparaison avec les autres outils : https://quelleia.com/outils/harnais/

- Terminal-Bench 2.0 · Grok 4.20 : 57,3 %

## Sources

- https://github.com/superagent-ai/grok-cli
- https://docs.x.ai/build/overview
- https://github.com/superagent-ai/grok-cli#install
- https://www.npmjs.com/package/grok-dev
- https://github.com/superagent-ai/grok-cli#run-it
- https://github.com/superagent-ai/grok-cli/blob/main/src/index.ts
- https://github.com/superagent-ai/grok-cli#what-you-actually-get
- https://github.com/superagent-ai/grok-cli#verify
- https://github.com/superagent-ai/grok-cli#scheduling
- https://github.com/superagent-ai/grok-cli#sandbox
- https://github.com/superagent-ai/grok-cli#computer-sub-agent
- https://www.superagent.sh/about
- https://github.com/superagent-ai
- https://github.com/superagent-ai/grok-cli/blob/main/LICENSE
- https://github.com/superagent-ai/grok-cli#api-key-pick-one
- https://github.com/superagent-ai/grok-cli/releases
- https://github.com/superagent-ai/grok-cli#telegram-remote-control--short-version

Non vérifié :

- L'activité du projet est incertaine : la dernière version (grok-dev 1.1.7) date du 15 mai 2026 et le dernier envoi sur le dépôt du 6 juillet 2026. Aucun abandon n'a été annoncé.
- Le pays de l'éditeur ne figure que sur le profil GitHub de l'organisation (« United States of America »). Le site de Superagent ne publie pas d'adresse.
- Le README ne dit pas si Windows et les Mac Intel sont pris en charge officiellement.
- Le titulaire des droits n'est pas nommé : le fichier LICENSE (MIT) a gardé le modèle « [year] [copyright holders] ».
