La page en anglais est plus récente que cette traduction. La lire en anglais

CLI

Shell
npm install -g instruction.md

Hors ligne, sans compte

CommandeCe qu’elle fait
instruction validate <file>vérifie un document avec le lecteur de la spécification : chaque problème avec sa ligne et un code stable. Les erreurs font échouer la commande (code de sortie 1) ; les avertissements, par exemple un ${name} que rien ne déclare, sont affichés sans la faire échouer, et --strict échoue aussi sur eux. Une ligne encore écrite selon la spécification 1.1 est une erreur
instruction init <name> --template agentun document de départ avec des règles et leurs raisons, une condition, une personne qui approuve, la forme de la réponse et un glossaire
instruction deliver <file> name=valuele texte exact que reçoit un modèle (instruction-text/1), ses bases et ses inclusions étant lues dans les fichiers voisins ; --resolved affiche le document résolu (instruction-resolved/1) avec son empreinte
instruction fmt <file> --writeune mise en forme prudente : fins de ligne, saut de ligne final, espaces en fin de ligne sur les lignes de directive
instruction tree <file>l’arbre du document tel qu’il est écrit (instruction/1), en JSON
instruction digest <file>l’empreinte du document tel qu’il est écrit : le SHA-256 des octets du fichier
instruction render <file> --fulldu HTML pour un site statique
instruction test <dir>exécute les vecteurs de conformité de la spécification, pour votre propre lecteur
instruction eval <file>exécute les cas :::eval du document avec Claude et vos propres identifiants ; --dry-run montre ce que chaque cas enverrait et n’appelle aucun modèle

Avec le registre

Ces commandes parlent MCP 2026-07-28 au serveur, sans état : pas de session, et chaque requête se suffit à elle-même, quelle que soit la réplique du serveur qui y répond.

CommandeCe qu’elle fait
instruction loginse connecter, dans votre navigateur ; la connexion est conservée dans votre dossier de configuration
instruction login --devicese connecter avec un code sur un autre appareil, pour une machine sans navigateur (par SSH, dans un conteneur)
instruction list, get, pulltrouver et récupérer
instruction push <file> --publishcréer ou mettre à jour un brouillon, et le publier
instruction publish <id> --tag v2 --refs latest,stablepublier le brouillon actuel et déplacer des références (refs)
instruction refs <id> set stable <ver>déplacer une référence ; c’est ainsi que l’on revient en arrière
instruction diff <id> <from> <to>les différences au format unifié et bloc par bloc
instruction watch <uri> --out FILEsuivre une référence, en gardant la dernière version valide
instruction connect --host claude-code <uri> --with-hooks --writefaire d’une instruction celle d’un projet dans Claude Code ou Codex (--host codex, Codex ; en anglais) : le fichier de liaison et les hooks
instruction hook claude-code, hook codexce que lancent ces hooks : l’instruction au début d’une session, et une nouvelle version avec la demande suivante
instruction sync <uri> --as claude-skillune instruction comme sous-agent ou compétence de Claude Code, ou compétence de Codex (claude-agent, codex-skill)
instruction connect --managed claude-code <uri>les réglages qui l’installent sur chaque machine d’une organisation (agents gérés, en anglais)
instruction audit export <id> --format csvle journal d’audit, jamais le contenu
instruction revoke <id> <ver>retirer une version ; les consommateurs gardent celle qu’ils avaient

Se connecter

instruction login ouvre votre navigateur sur la page de connexion de instruction.md. Connectez-vous, acceptez ce que demande la ligne de commande, et le navigateur affiche « Vous êtes connecté » : revenez au terminal. Votre navigateur ne remet la connexion qu’à la commande, sur votre propre ordinateur (une adresse sur 127.0.0.1, ouverte pour cette seule connexion), et la commande prouve que c’est elle qui a lancé la connexion (PKCE) : une connexion qui aboutit ailleurs est donc refusée. Si rien ne revient au bout de 5 minutes, la commande s’arrête et le dit.

Pour instruction.md, la commande ne se connecte que sur la page de connexion de instruction.md ; pour un serveur que vous nommez avec --url, que sur une page de connexion située à la même adresse que ce serveur. Un serveur qui nomme la page de connexion de quelqu’un d’autre pourrait récupérer votre connexion : il est donc refusé. --issuer passe outre, après vous avoir demandé (ou avec --trust-issuer là où il n’y a pas de terminal pour demander), mais la connexion de instruction.md n’est jamais utilisée pour un autre serveur. Chaque jeton est vérifié : il doit provenir du service de connexion qui l’a émis et être destiné au serveur auquel il est envoyé. La connexion de instruction.md ignore le paramètre resource de la RFC 8707 qu’envoie la commande : c’est donc cette vérification qui lie le jeton au serveur.

Pas de navigateur sur la machine, par exemple par SSH ou dans un conteneur ? La commande affiche le lien et suggère instruction login --device : elle montre un code court et un lien à ouvrir sur n’importe quel appareil, y compris votre téléphone. Le code est valable 5 minutes.

Administrer une organisation (ajouter ou renouveler des clés d’éditeur, créer ou révoquer des agents, consulter le journal d’audit) demande une autorisation supplémentaire. instruction login --admin la demande d’emblée ; sinon, la première commande qui en a besoin vous pose la question dans le terminal et vous reconnecte avec elle. Sans terminal, elle ne change rien et vous dit de lancer instruction login --admin (--yes ne lance pas de connexion), et une connexion avec un autre compte est refusée.

Dans la CI

Définissez INSTRUCTION_MD_TOKEN pour un jeton non interactif et utilisez --json pour une sortie lisible par une machine. Codes de sortie : 1 erreur, 2 mauvaise utilisation, 3 transport ou non connecté, 4 introuvable, 5 interdit, 6 rien n’a été appliqué, 7 non confirmé.

GitHub Actions
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npm i -g instruction.md
      - run: instruction validate RUNBOOK.md
      - run: instruction push RUNBOOK.md --to ${{ vars.INSTRUCTION_ID }} --publish --yes --message "${{ github.sha }}" --json
        env:
          INSTRUCTION_MD_URL: https://instruction.md/mcp
          INSTRUCTION_MD_TOKEN: ${{ secrets.INSTRUCTION_MD_TOKEN }}

Ajoutez --sign-with key.json pour publier avec votre propre clé plutôt qu’avec celle de la plateforme. Voir signature et confiance.