Uso

O Helm oferece um conjunto pequeno de comandos CLI para inicializar projetos, verificar status, retomar sessões e fazer checkpoint do estado.

helm init

Inicializar um novo projeto ou reinicializar um existente.

helm init
helm init --name my-api --type brownfield --lang pt-BR
helm init --force

Flag	Descrição	Padrão
`--name`	Nome do projeto	Nome do diretório atual
`--type`	Tipo: `greenfield` ou `brownfield`	Auto-detectado
`--lang`	Idioma: `en-US` ou `pt-BR`	`en-US`
`--force`	Reinicializar projeto existente	`false`

Cria .helm/session.yaml (estado em tempo de execução) e helm.yaml (configuração do projeto).

helm status

Exibir o dashboard de progresso do pipeline.

helm status
helm status --short
helm status --json

Flag	Descrição
`--short`	Resumo em uma linha
`--json`	Saída JSON legível por máquina

helm resume

Mostrar contexto e próximos passos para retomar em uma nova sessão do Claude Code.

helm resume
helm resume --json

Exibe o agente atual, último agente completado com score, e o que fazer em seguida. Use após abrir uma nova janela do Claude Code para retomar de onde parou.

helm save

Fazer checkpoint do estado da sessão para handoff seguro entre conversas.

helm save
helm save --message "antes do refactor"
helm save --force

Flag	Descrição
`--message`	Descrição do checkpoint
`--force`	Pular aviso de checkpoint recente

Antes de fazer checkpoint, helm save valida:

Campos obrigatórios existem em session.yaml
Arquivos de handoff existem para agentes completados
Diretórios de artefatos existem para agentes completados

Mantém os últimos 5 checkpoints com rotação FIFO.

helm version

Imprimir a versão instalada do Helm.

helm version

Flags Globais

Flag	Descrição
`--no-color`	Desabilitar saída colorida

Cores são automaticamente desabilitadas ao redirecionar saída ou quando a variável de ambiente NO_COLOR está definida.

Dentro do Claude Code

Dentro do Claude Code, use o comando /helm para ativar o orquestrador. A CLI complementa o Claude Code — use-a standalone para verificar status e fazer checkpoint do estado.

/helm          # ativar orquestrador
/helm status   # mostrar dashboard
/helm resume   # retomar do último agente
/helm exit     # desativar lock da sessão