CLI
npm install -g instruction.md Sin conexión, sin necesidad de cuenta
| Comando | Qué hace |
|---|---|
instruction validate <file> | comprueba un documento con el lector de la especificación: cada problema con su línea y un código estable. Los errores hacen fallar el comando (código de salida 1); las advertencias, como un ${name} que nada declara, se muestran y no lo hacen fallar, y con --strict también fallan. Una línea escrita todavía según la especificación 1.1 es un error |
instruction init <name> --template agent | un documento inicial con reglas y sus motivos, una condición, una persona que aprueba, la forma de la respuesta y un glosario |
instruction deliver <file> name=value | el texto exacto que recibe un modelo (instruction-text/1), con sus bases e inclusiones leídas de los archivos que tiene al lado; --resolved imprime el documento resuelto (instruction-resolved/1) con su digest |
instruction fmt <file> --write | formato conservador: los finales de línea, el salto de línea final, los espacios al final de las líneas de directiva |
instruction tree <file> | el árbol del documento tal como se escribió (instruction/1), en JSON |
instruction digest <file> | el digest del documento tal como se escribió: el SHA-256 de los bytes del archivo |
instruction render <file> --full | HTML para un sitio estático |
instruction test <dir> | ejecuta los vectores de conformidad de la especificación, para tu propio lector |
instruction eval <file> | ejecuta los casos :::eval del documento contra Claude con tus propias credenciales; --dry-run muestra lo que enviaría cada caso y no llama a ningún modelo |
Contra el registro
Estos comandos hablan MCP 2026-07-28 con el servidor, sin estado: no hay sesión, y cada petición se sostiene por sí sola, la responda la réplica del servidor que la responda.
| Comando | Qué hace |
|---|---|
instruction login | iniciar sesión, en tu navegador; la sesión se guarda en tu directorio de configuración |
instruction login --device | iniciar sesión con un código en otro dispositivo, para una máquina sin navegador (por SSH, en un contenedor) |
instruction list, get, pull | buscar y descargar |
instruction push <file> --publish | crear o actualizar un borrador, y publicarlo |
instruction publish <id> --tag v2 --refs latest,stable | publicar el borrador actual y mover referencias |
instruction refs <id> set stable <ver> | mover una referencia, que es como se vuelve a una versión anterior |
instruction diff <id> <from> <to> | diferencias en formato unificado y por bloques |
instruction watch <uri> --out FILE | seguir una referencia, conservando la última versión válida |
instruction connect --host claude-code <uri> --with-hooks --write | hacer de una instrucción la de un proyecto en Claude Code o Codex (--host codex, Codex; en inglés): el archivo de vínculo y los hooks |
instruction hook claude-code, hook codex | lo que ejecutan esos hooks: la instrucción al empezar una sesión y una nueva versión con la siguiente petición |
instruction sync <uri> --as claude-skill | una instrucción como subagente o habilidad de Claude Code, o habilidad de Codex (claude-agent, codex-skill) |
instruction connect --managed claude-code <uri> | la configuración que la lleva a cada equipo de una organización (agentes gestionados, en inglés) |
instruction audit export <id> --format csv | el registro de auditoría, nunca el contenido |
instruction revoke <id> <ver> | retirar una versión; los consumidores conservan la que tenían |
Iniciar sesión
instruction login abre tu navegador en la página de inicio de sesión de instruction.md. Inicia
sesión, acepta lo que pide la línea de comandos, y el navegador muestra «Has iniciado sesión»:
vuelve a la terminal. Tu navegador devuelve el inicio de sesión al comando solo en tu propio ordenador (una
dirección en 127.0.0.1, abierta para este único inicio de sesión), y el comando demuestra que fue él
quien lo empezó (PKCE), así que un inicio de sesión que termina en cualquier otro lugar se rechaza. Si no vuelve
nada en 5 minutos, se detiene y lo dice.
Para instruction.md, el comando inicia sesión solo en la página de inicio de sesión propia de instruction.md; para
el servidor que nombres con --url, solo en una que esté en la misma dirección que ese servidor. Un
servidor que nombra la página de inicio de sesión de otro podría capturar tu inicio de sesión, así que se rechaza;
--issuer anula esa regla, después de preguntarte (o con --trust-issuer donde no hay
terminal en la que preguntar), salvo que el inicio de sesión propio de instruction.md nunca se usa para otro
servidor. De cada token se comprueba que viene del servicio de inicio de sesión del que llegó y que es para el
servidor al que va: el inicio de sesión de instruction.md ignora el parámetro resource de RFC 8707
que envía el comando, así que esa comprobación es la que liga el token al servidor.
¿No hay navegador en la máquina, como por SSH o en un contenedor? El comando imprime el enlace y sugiere
instruction login --device: muestra un código corto y un enlace para abrir en cualquier dispositivo,
también tu teléfono. El código es válido durante 5 minutos.
Administrar una organización (añadir o rotar claves de editor, crear o revocar agentes, el registro de auditoría)
requiere un permiso más. instruction login --admin lo pide de entrada; si no, el primer comando que
lo necesita te pregunta en la terminal y vuelve a iniciar tu sesión con él. Sin terminal no cambia nada y te
indica que ejecutes instruction login --admin (--yes no inicia una sesión), y un inicio
de sesión con otra cuenta se rechaza.
En CI
Define INSTRUCTION_MD_TOKEN para un token no interactivo y usa --json para obtener una
salida legible por máquinas. Códigos de salida: 1 error, 2 uso incorrecto, 3 fallo de transporte o sesión no
iniciada, 4 no encontrado, 5 prohibido, 6 nada aplicado, 7 no confirmado.
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 }}
Añade --sign-with key.json para publicar con tu propia clave en lugar de la de la plataforma.
Consulta firma y confianza.