Referência do CLI

Consulte o estado

Comece pelo diagnóstico e pelo panorama. Consultas de thread, fases e claims explicam o que foi registrado; não concedem permissão de escrita. Use --help no comando específico antes de uma operação mutável.

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

Comandos por responsabilidade

Condução reúne thread, phase, modos e gate. Evidência usa claims, verify, fix e retry. Isolamento usa worktree e lease. Continuidade usa handoff, recall e memory. Entrega usa ship e master. Auditoria usa audit e divida.

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

Integrações e operação

adapter e mcp conectam o host. accounts e setup descrevem runtimes e perfis. sessions, monitor e pulse observam execução e atenção humana. brain e portfolio consultam memória e catálogo. fabrica, roadmap e network coordenam trabalho entre máquinas, e projetos diz qual projeto cada comando lê. grafo consulta o índice local do grafo de código. A referência canônica no repositório detalha as opções de cada família.

Contexto citável e atenção humana

brain context devolve entidades, pais, citações, frescor e lacunas sem conceder permissão de escrita. roadmap status monta um relatório de leitura com a atenção que cabe ao dono. master pedir gera o pedido de nota para resposta pelo canal autenticado; não é uma nota dada pelo agente.

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

Escolha o projeto consultado

Todo comando lê um projeto. Vale, nesta ordem: --projeto <nome|caminho>, em qualquer posição do comando; a variável ORK_PROJETO; no host sem diretório de projeto, o único projeto conhecido ou a recusa projeto.escolha; e, no terminal, o diretório atual. Nome ambíguo ou desconhecido recusa com os candidatos, na saída 4; o ork nunca escolhe no lugar de quem pediu.

ork projetos lista os projetos conhecidos desta máquina, sem segredo. ork init, ork thread new e ork fabrica entrar registram sozinhos; registrar e esquecer cuidam das cópias antigas, sem apagar nada do disco. maestro, board, board plan, fabrica e roadmap status começam dizendo o projeto consultado e o que não foi lido.

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

Rede, reservas e números de feature

network roadmap junta o roadmap da rede de qualquer diretório, com lacuna tipada no que não leu. roadmap reservas marca a reserva órfã de thread já fechada nesta máquina, e --soltar-orfas a solta ou a passa para outra thread aberta do mesmo item, com registro. roadmap feat reserva o próximo número de FEAT por push atômico; duas máquinas nunca levam o mesmo número, e o número reservado não volta.

docs sincronizar leva fatos do ledger e do git aos itens do roadmap. --so limita aos itens pedidos; na worktree de uma thread com item, o padrão é o item dela, e --todos volta a todos.

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

Entrega, CI e concorrência

ci prepare grava .ork-ci/<thread>.json na worktree da thread, com a branch dela; ci run --branch acha esse bundle pelo nome da branch, reprova branch ork/* sem bundle e, fora de thread, roda só os comandos do manifesto. ship registrar-pr --repo --pr registra PR mesclado num repositório externo declarado em ci.external_repositories, com o merge conferido pela API do GitHub e o check declarado verde no head do PR.

phase run recusa com concurrency.limite, na saída 3, quando o projeto já tem max_parallel_threads sessões vivas em outras threads; --esperar espera a vaga. Na sessão sem acesso ao ledger, a ferramenta MCP ork_decision_record grava a decisão pelo mesmo contrato de decisao registrar.

ork ci prepare <thread>
ork ci run --branch <branch>
ork ship registrar-pr <thread> --repo <dono/nome> --pr <n>
ork phase run <thread> GO --prompt "<texto>" --esperar

Busca por significado na memória

memory search --texto busca por significado no tenant, com vetor e FTS combinados, e não é determinística; não combina com --tags nem --thread. memory index mantém o índice vetorial local, idempotente, e --dry-run estima tokens e custo sem chamar o provider. memory status --sondar faz uma chamada real e mede a latência.

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

Consulte o grafo de código

grafo indexar constrói o índice do HEAD limpo, no estado do projeto e fora do git; --verificar extrai de novo e confere contrato, bytes e determinismo. vizinhos, chamadores, importadores e caminho respondem pelas arestas, em texto ou --json, com o extrator e a evidência de cada uma. status mostra o índice do HEAD, amostra serve à auditoria manual de arestas e limpar apaga os índices que não são do HEAD de nenhuma árvore.

A resposta é parcial por construção: só o que o extrator prova, e ela diz isso. Com a árvore modificada, a resposta é a do HEAD, com aviso. Todo o ork grafo precisa do typescript e do micromark instalados no próprio pacote do ork; sem eles, a recusa é grafo.parser.indisponivel.

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