CLI
npm install -g instruction.md Hors ligne, sans compte
| Commande | Ce 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 agent | un 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=value | le 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> --write | une 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> --full | du 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.
| Commande | Ce qu’elle fait |
|---|---|
instruction login | se connecter, dans votre navigateur ; la connexion est conservée dans votre dossier de configuration |
instruction login --device | se connecter avec un code sur un autre appareil, pour une machine sans navigateur (par SSH, dans un conteneur) |
instruction list, get, pull | trouver et récupérer |
instruction push <file> --publish | créer ou mettre à jour un brouillon, et le publier |
instruction publish <id> --tag v2 --refs latest,stable | publier 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 FILE | suivre une référence, en gardant la dernière version valide |
instruction connect --host claude-code <uri> --with-hooks --write | faire 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 codex | ce 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-skill | une 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 csv | le 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é.
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.