La CLI Pilot

La CLI Pilot (@braike/pilot, commande pilot) branche Pilot MCP depuis votre terminal, sans copier de configuration à la main. Elle vous connecte par votre navigateur, inscrit le serveur Pilot dans vos assistants, sert de pont aux clients qui ne lancent que des programmes locaux, installe les skills, et interroge Pilot depuis un script.

InstallerCopier le lien de la section

Il faut Node.js 20 ou plus. Sans rien installer, npx télécharge la CLI et la lance :

npx @braike/pilot setup

Pour garder la commande pilot sous la main, installez-la une fois pour toutes :

npm install -g @braike/pilot
pilot --version

Les exemples de cette page écrivent pilot ; avec npx, remplacez pilot par npx @braike/pilot.

En deux commandesCopier le lien de la section

npx @braike/pilot login
npx @braike/pilot setup

login ouvre l'écran d'autorisation de Pilot dans votre navigateur ; setup trouve les assistants installés sur votre ordinateur et y inscrit Pilot. Redémarrez ensuite votre assistant et posez-lui une question.

Les commandesCopier le lien de la section

pilot loginCopier le lien de la section

Ouvre la connexion à Pilot dans votre navigateur (OAuth 2.1). Vous choisissez l'espace à partager et gardez le niveau Lecture, comme pour un assistant (voir l'écran d'autorisation). La CLI garde ensuite le jeton reçu sur votre ordinateur.

pilot login
pilot login --workspace <id de l'espace>
pilot login --no-browser

--workspace verrouille l'autorisation sur un espace, comme l'adresse d'un espace. --no-browser affiche l'adresse à ouvrir au lieu d'ouvrir le navigateur, par exemple sur un serveur.

pilot logoutCopier le lien de la section

Révoque l'accès de la CLI auprès de Pilot, puis efface les jetons gardés sur cet ordinateur. Sans --workspace, toutes les connexions de l'adresse.

pilot logout
pilot logout --workspace <id de l'espace>

Quand Pilot ne peut pas répondre (indisponibilité, réseau), la connexion est gardée et la commande échoue, pour être relancée. --force l'oublie quand même sur cet ordinateur.

pilot statusCopier le lien de la section

Dit si la CLI est connectée, à quelle adresse, pour quel espace, à quel niveau, jusqu'à quand, et si elle peut renouveler le jeton seule. Elle n'affiche jamais de jeton, et rend le code 1 quand aucune connexion n'est utilisable.

pilot status

pilot setupCopier le lien de la section

Inscrit le serveur Pilot dans les assistants trouvés sur votre ordinateur. Sans --client, la CLI l'inscrit dans chacun d'eux ; --all le dit explicitement.

pilot setup
pilot setup --client cursor
pilot setup --client claude-code --client vscode
pilot setup --client cursor --dry-run
pilot setup --client generic

Les assistants pris en charge, le nom à donner à --client, et ce que la CLI écrit :

Un assistant qui parle MCP à distance reçoit l'adresse de Pilot et se connecte lui-même au premier usage, par le même écran d'autorisation : Claude Code avec /mcp (ou claude mcp login pilot), Codex avec codex mcp login pilot, Gemini CLI avec /mcp auth pilot ; Cursor, VS Code et Windsurf ouvrent la page d'autorisation au premier usage. La configuration de Claude Desktop ne garde que des serveurs locaux : il reçoit le pont pilot mcp, connecté par pilot login. Claude sur claude.ai et ChatGPT dans le navigateur se branchent depuis leur interface : voir Brancher son assistant.

Avant de modifier un fichier, la CLI en garde une copie datée dans ~/.config/pilot/backups/ ; relancée, elle ne crée pas de doublon. Seule l'entrée Pilot change : un fichier JSON est réécrit avec sa propre indentation, et dans le TOML de Codex seule la table de Pilot change. Trois cas vous sont laissés, sauf --force :

• un fichier dont le vrai chemin, liens suivis, sort de votre dossier personnel et des dossiers de configuration (XDG_CONFIG_HOME, APPDATA, LOCALAPPDATA, CODEX_HOME, CLAUDE_CONFIG_DIR) ;
• une entrée du même nom qui n'est pas celle de Pilot : choisissez un autre nom avec --name ;
• un fichier JSON avec des commentaires, que --force réécrit sans eux.

pilot removeCopier le lien de la section

Retire l'entrée Pilot de la configuration des assistants, sans toucher au reste. Une entrée du même nom qui n'est pas celle de Pilot reste en place, sauf --force.

pilot remove --client cursor
pilot remove --all --dry-run

Options : --client <nom>, --all, --name <nom>, --dry-run, --force.

pilot mcpCopier le lien de la section

Lance un serveur MCP local en stdio qui relaie le serveur distant de Pilot : c'est le pont des assistants qui ne savent lancer qu'un programme local. Dans la configuration d'un tel assistant :

{
  "mcpServers": {
    "pilot": {
      "command": "npx",
      "args": ["-y", "@braike/pilot", "mcp"]
    }
  }
}

• Identifiant : la clé d'accès de la variable PILOT_API_KEY quand elle est définie, sinon la connexion de pilot login, relue à chaque requête : une connexion faite ailleurs sert tout de suite. Le pont renouvelle le jeton avant qu'il expire.
• Sans connexion, le pont ouvre lui-même la connexion à Pilot dans votre navigateur et répond une erreur à l'assistant le temps que vous vous connectiez ; réessayez ensuite. Quand aucun navigateur ne peut s'ouvrir (un serveur, PILOT_NO_BROWSER), chaque requête reçoit une erreur qui dit de lancer npx @braike/pilot login.
• Un espace précis : --workspace <id>, ou la variable PILOT_WORKSPACE.

pilot toolsCopier le lien de la section

Liste les outils que Pilot vous sert, un par ligne.

pilot tools
pilot tools --json | jq '.[].name'

pilot callCopier le lien de la section

Appelle un outil et affiche sa réponse. Un outil en erreur rend le code de sortie 1, pour les scripts.

pilot call pilot_data_freshness
pilot call google_get_campaign_performance --arg customer_id=1234567890 --arg date_range=LAST_7_DAYS
pilot call google_analytics_run_report --json-args '{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":["sessionDefaultChannelGroup"],"metrics":["sessions"]}'

--arg cle=valeur se répète et suit le type que déclare le schéma de l'outil : un nombre, un booléen, une liste ou un objet sont lus comme tels, le reste reste du texte. --arg cle:=<json> passe une valeur JSON telle quelle. --json-args passe un objet, que les --arg complètent ou remplacent. Les outils et leurs paramètres sont sur Les régies et leurs outils.

pilot skills list et pilot skills installCopier le lien de la section

Liste le catalogue des skills et les installe là où votre assistant les lit.

pilot skills list
pilot skills install
pilot skills install google-ads-account-audit --target claude-code
pilot skills install --target claude --out ./archives
pilot skills install --target ./.github/skills

Sans nom de skill, la CLI installe tout le catalogue ; sans --target, elle installe dans chaque assistant trouvé parmi Claude Code, Codex et Cursor. Elle remplace le dossier d'une skill d'un bloc ; un dossier modifié à la main depuis son installation reste tel quel, sauf --force. --dry-run montre ce qui serait installé.

La CLI lit le catalogue que publie cette documentation, https://pilot.braike.com/skills/index.json, et vérifie la taille et l'empreinte SHA-256 de chaque fichier avant d'écrire : un seul écart refuse la skill entière.

pilot doctorCopier le lien de la section

Vérifie votre installation : version de Node.js, version de la CLI au regard de la dernière publiée, accès au réseau, découverte de la connexion de Pilot, validité de votre identifiant, et assistants configurés. Une version plus récente n'est qu'un avertissement, avec la commande de mise à jour. Une vérification en échec rend le code 1. Voir Dépannage.

pilot doctor

pilot openCopier le lien de la section

Ouvre la console de votre espace, la page Claude et ChatGPT, dans votre navigateur ; sans espace connu, la liste de vos espaces. --no-browser affiche l'adresse.

pilot open
pilot open --workspace <id de l'espace>

pilot --version donne la version, pilot help <commande> l'aide d'une commande.

Options communesCopier le lien de la section

Variables d'environnementCopier le lien de la section

Codes de sortieCopier le lien de la section

SécuritéCopier le lien de la section

• Vos jetons restent chez vous, dans ~/.config/pilot/credentials.json : un dossier que vous seul pouvez lire (droits 0700, fichier 0600), écrit d'un bloc. Des droits relâchés sont resserrés ; sous Windows, la protection de votre profil utilisateur s'applique.
• Un jeton ne part que vers l'adresse qui l'a émis. Les métadonnées du serveur d'autorisation doivent nommer l'adresse choisie, et chacun de ses points d'accès lui appartenir, sinon la connexion est refusée. Les redirections ne sont jamais suivies.
• Seulement les adresses de Pilot, en HTTPS ; une adresse locale seulement avec --allow-local.
• Connexion OAuth 2.1 : PKCE S256 et state vérifié, retour sur http://127.0.0.1 à un port choisi au hasard, client enregistré une fois puis réutilisé, indicateur de ressource. pilot logout révoque les jetons, et une nouvelle connexion révoque, quand elle le peut, le jeton qu'elle remplace.
• Rien d'affiché : aucun jeton, aucune clé, aucun code ni secret, même avec --verbose. Les séquences de contrôle d'un texte venu d'un serveur sont retirées.
• Vos configurations protégées : copie datée avant tout changement, seule l'entrée Pilot change, aucune écriture hors de vos dossiers ni sur l'entrée d'un autre sans --force, et --dry-run pour voir avant.
• Aucune dépendance : le paquet ne s'appuie que sur Node.js, sans aucun autre paquet npm : aucun paquet tiers ne touche à vos jetons.

DépannageCopier le lien de la section

Lancez d'abord pilot doctor : chaque vérification en échec dit où chercher.