Referencia del CLI

Consulte el estado

Empiece por el diagnóstico y el panorama. Las consultas de thread, fases y claims explican el estado registrado; no conceden permiso de escritura. Use --help en el comando concreto antes de modificar datos.

ork doctor
ork maestro --json
ork thread status <thread>
ork phase list <thread>
ork claims list <thread>

Comandos por responsabilidad

La conducción reúne thread, phase, modos y gate. Las pruebas usan claims, verify, fix y retry. El aislamiento usa worktree y lease. La continuidad usa handoff, recall y memory. La entrega usa ship y master. La auditoría usa audit y divida.

ork --help
ork ship --help
ork master --help

Integraciones y operación

adapter y mcp conectan el host. accounts y setup describen runtimes y perfiles. sessions, monitor y pulse observan la ejecución y la atención humana. brain y portfolio consultan memoria y catálogo. fabrica, roadmap y network coordinan el trabajo entre máquinas, y projetos indica qué proyecto lee cada comando. grafo consulta el índice local del grafo de código. La referencia canónica del repositorio detalla las opciones de cada familia.

Contexto citable y atención humana

brain context devuelve entidades, padres, citas, vigencia y lagunas sin conceder escritura. roadmap status crea un informe de lectura con lo que requiere atención del dueño. master pedir genera la solicitud de nota para una respuesta humana autenticada; no es una nota dada por el agente.

ork brain context --thread <thread> --ids <ids>
ork roadmap status --json
ork master pedir <thread> --formato telegram

Elija el proyecto consultado

Cada comando lee un proyecto, en este orden: --projeto <nombre|ruta>, en cualquier posición del comando; la variable ORK_PROJETO; en un host sin directorio de proyecto, el único proyecto conocido o el rechazo projeto.escolha; y, en el terminal, el directorio actual. Un nombre ambiguo o desconocido se rechaza con los candidatos, con código de salida 4; ork nunca elige en nombre de quien pidió.

ork projetos enumera los proyectos conocidos de esta máquina, sin secretos. ork init, ork thread new y ork fabrica entrar registran automáticamente; registrar y esquecer gestionan las copias antiguas sin borrar nada del disco. maestro, board, board plan, fabrica y roadmap status empiezan indicando el proyecto consultado y lo que no se leyó.

ork projetos --json
ork roadmap status --projeto meu-produto
ork projetos registrar
ork projetos esquecer <nombre>

Red, reservas y números de feature

network roadmap reúne el roadmap de la red desde cualquier directorio, con lagunas tipadas para lo que no leyó. roadmap reservas marca la reserva huérfana de una thread ya cerrada en esta máquina, y --soltar-orfas la libera o la pasa a otra thread abierta del mismo elemento, con registro. roadmap feat reserva el siguiente número de FEAT mediante un push atómico; dos máquinas nunca reciben el mismo número, y el número reservado no se reutiliza.

docs sincronizar lleva hechos del ledger y de git a los elementos del roadmap. --so limita la operación a los elementos pedidos; en la worktree de una thread con elemento, el predeterminado es el suyo, y --todos vuelve a cubrirlos todos.

ork network roadmap --json
ork roadmap reservas --soltar-orfas
ork roadmap feat --thread <thread>
ork docs sincronizar --escrever --so RM-NNN

Entrega, CI y concurrencia

ci prepare escribe .ork-ci/<thread>.json en la worktree de la thread, con su branch; ci run --branch encuentra ese bundle por el nombre de la branch, rechaza una branch ork/* sin bundle y, fuera de una thread, ejecuta solo los comandos del manifiesto. ship registrar-pr --repo --pr registra un PR fusionado en un repositorio externo declarado en ci.external_repositories, con el merge comprobado mediante la API de GitHub y el check declarado en verde en el head del PR.

phase run rechaza con concurrency.limite, código de salida 3, cuando el proyecto ya tiene max_parallel_threads sesiones vivas en otras threads; --esperar espera un hueco. En una sesión sin acceso al ledger, la herramienta MCP ork_decision_record registra la decisión con el mismo contrato que decisao registrar.

ork ci prepare <thread>
ork ci run --branch <branch>
ork ship registrar-pr <thread> --repo <dueño/nombre> --pr <n>
ork phase run <thread> GO --prompt "<texto>" --esperar

Búsqueda por significado en la memoria

memory search --texto busca por significado en el tenant, combinando vector y FTS, y no es determinista; no se combina con --tags ni --thread. memory index mantiene el índice vectorial local e idempotente, y --dry-run estima tokens y coste sin llamar al provider. memory status --sondar hace una llamada real y mide la latencia.

ork memory status --sondar
ork memory index --dry-run --json
ork memory search --texto "<frase>" --json

Consulte el grafo de código

grafo indexar construye el índice del HEAD limpio, en el estado del proyecto y fuera de git; --verificar vuelve a extraer y comprueba contrato, bytes y determinismo. vizinhos, chamadores, importadores y caminho responden a partir de las aristas, en texto o --json, con el extractor y la prueba de cada una. status muestra el índice del HEAD, amostra sirve para auditar aristas a mano y limpar borra los índices que no son del HEAD de ningún árbol.

La respuesta es parcial por construcción: solo contiene lo que el extractor demuestra, y lo indica. Con el árbol modificado, la respuesta corresponde al HEAD, con aviso. Todo ork grafo necesita typescript y micromark instalados dentro del propio paquete de ork; sin ellos, el rechazo es grafo.parser.indisponivel.

ork grafo indexar --verificar
ork grafo status
ork grafo chamadores <símbolo>
ork grafo importadores <archivo> --json
ork grafo caminho <de> <a>