CLI neuro-harness

A CLI neuro-harness instala, sobe, para e diagnostica o Neuro Harness. Ela não tem dependências e funciona no macOS, no Linux e no Windows. Esta página descreve cada comando.

Uso geral

neuro-harness <comando> [opções]

Sem comando, a CLI mostra a ajuda.
Comando desconhecido mostra Comando desconhecido: <comando>, a ajuda, e sai com o código 2.
Erros aparecem com ✗ e saem com o código 1.
Variáveis de ambiente mudam pastas, perfil e porta. Veja Variáveis de ambiente.

Comando	Resumo
`setup`	Instala ou atualiza o Harness, o motor, o perfil e os plugins
`start`	Sobe o Harness em segundo plano
`stop`	Para o Harness
`restart`	Para e sobe de novo
`status`	Mostra se está rodando
`url`	Mostra o endereço local com o token
`open`	Abre o painel no navegador
`doctor`	Confere a instalação inteira
`deps`	Confere os pré-requisitos do sistema
`engine`	Instala ou troca o motor neuro-mv-edit
`credenciais`	Importa chaves de API do Hermes e do OpenCode
`run`	Roda uma tarefa sem interface
`version`	Mostra a versão
`help`	Mostra a ajuda

neuro-harness setup

neuro-harness setup [--link]

Instala ou atualiza tudo o que a distribuição precisa, sem refazer o que já está certo. Rode de novo quando quiser reparar a instalação.

Opção	O que faz
`--link`	Liga os plugins `neuro-harness-brand` e `neuro-harness-pt-br` direto da pasta do código, em vez de copiá-los. Para desenvolvimento

O que o setup faz, em ordem:

Cria a pasta da distribuição, a pasta de trabalho (~/Neuro), a biblioteca do neuro-mv-edit (~/.neuro-mv-edit) e o cache npm das sessões.
Instala o DeepSeek Harness 0.2.1-alpha.2 em ~/.neuro-harness/runtime, com o npm do sistema. Na primeira vez, baixa cerca de 550 MB.
Baixa o motor neuro-mv-edit da tag fixada (v1.8.0) para ~/.neuro-harness/engine/neuro-mv-edit/1.8.0 e aponta current para ela.
Cria os atalhos neuro-mv-edit e neuro-mv-edit.cmd em ~/.neuro-harness/bin.
Cria o perfil neuro a partir do modelo Web do Harness e mantém nele o bloco gerenciado da distribuição.
Copia os plugins de marca e idioma para ~/.neuro-harness/plugins e os instala no perfil. Um plugin sem o bundle de cliente é pulado, com aviso.
Baixa o neuro-ads-manager da tag fixada (v0.1.0) para ~/.neuro-harness/addons/neuro-ads-manager/0.1.0.
Instala no perfil o neuro-mv-edit, o neuro-ads-manager e os cinco plugins oficiais, fixados por versão.

O motor e o neuro-ads-manager vêm de repositórios privados. O git da máquina precisa de acesso, por gh auth login ou chave SSH.

Exemplo:

neuro-harness setup

No fim, o setup mostra uma linha por etapa:

✓ DeepSeek Harness 0.2.1-alpha.2  ✓ motor neuro-mv-edit v1.8.0  ✓ perfil neuro
✓ plugin neuro-harness-brand
✓ plugin neuro-harness-pt-br
✓ neuro-ads-manager v0.1.0
✓ no perfil: neuro-mv-edit
✓ no perfil: neuro-ads-manager
✓ no perfil: @deepseek-ai/dsh-experimental-agent-team-profile
✓ no perfil: @deepseek-ai/dsh-experimental-auto-review
✓ no perfil: @deepseek-ai/dsh-experimental-session-search
✓ no perfil: @deepseek-ai/dsh-experimental-terminal-bundle
✓ no perfil: @deepseek-ai/dsh-experimental-session-titles-bundle
Pronto. Suba com: neuro-harness start

Uma etapa com falha aparece com ✗ e a mensagem do erro.

neuro-harness start

neuro-harness start

Sobe o Harness em segundo plano, como processo próprio, e mostra o endereço local com o token. Sem opções.

Já rodando: reaproveita o processo e mostra Neuro Harness já estava no ar.
Endereço: só em 127.0.0.1. A porta padrão é a 3082 (NEURO_HARNESS_PORT). Se ela estiver ocupada, usa uma porta livre.
Pasta: o Harness roda na pasta de trabalho (NEURO_WORKDIR), com o perfil neuro e o ambiente limpo das sessões.
Arquivos: grava o PID em ~/.neuro-harness/harness.pid e o log em ~/.neuro-harness/harness.log. O log é zerado a cada start.
Tempo limite: se o Harness não mostrar o endereço em 90 segundos, o comando falha com o Harness não subiu e mostra o fim do log.

Exemplo:

neuro-harness start

Neuro Harness no ar: http://127.0.0.1:3082/?token=<token>
No navegador, abra este endereço (com o token) uma vez: o navegador guarda um acesso válido por 30 dias,
mesmo depois de reiniciar, e aí http://127.0.0.1:3082/ funciona direto. Ou rode: neuro-harness open

Veja Painel e acesso pelo navegador.

neuro-harness stop

neuro-harness stop

Para o Harness e espera o processo sair. Sem opções.

macOS e Linux: envia um sinal de encerramento ao grupo do processo. Se ele não sair em 30 segundos, força o fim.
Windows: usa taskkill, com /F se o processo não sair.

Mostra parado, ou não estava rodando se não havia Harness no ar.

neuro-harness stop

neuro-harness restart

neuro-harness restart

Para o Harness, sobe de novo e mostra o endereço, como o start. Sem opções. Use depois de instalar ou remover um plugin, ou depois de mudar variáveis de ambiente.

neuro-harness restart

neuro-harness status

neuro-harness status

Mostra se o Harness está rodando, com o PID e o endereço. Sem opções.

Saída	Código de saída
`rodando (pid <pid>): <endereço>`	0
`parado`	1

neuro-harness status

neuro-harness url

neuro-harness url

Imprime o endereço local com o token, lido do log do Harness. Sem opções. Sai com o código 1, sem imprimir nada, quando ainda não há endereço.

neuro-harness url

neuro-harness open

neuro-harness open

Sobe o Harness, se ele não estiver rodando, e abre o endereço com o token no navegador padrão. Também imprime o endereço. Sem opções.

neuro-harness open

neuro-harness doctor

neuro-harness doctor

Confere a instalação inteira e mostra um item por linha, aprovado ou não. Quando existe um comando que resolve, o item reprovado o mostra entre parênteses. Sem opções. Sai com o código 0 se tudo passar e 1 se algo falhar.

Item	O que confere
Node.js	Versão 22 ou maior
git, Python, FFmpeg	Se estão no PATH (`python3`, ou `python` no Windows)
DeepSeek Harness	Versão instalada em `~/.neuro-harness/runtime` igual à fixada
Motor neuro-mv-edit	Versão do motor e o atalho em `~/.neuro-harness/bin`
Perfil	Se o perfil `neuro` existe
Plugins	Marca, idioma, neuro-mv-edit, neuro-ads-manager e os cinco oficiais, na versão certa
Chaves	Quantas chaves há no cofre, com os nomes das referências (nunca os valores)
Cache npm	A pasta de cache das sessões e, fora do Windows, se `~/.npm` tem arquivos do root
Harness	Se está rodando, com o PID e o endereço

neuro-harness doctor

neuro-harness deps

neuro-harness deps

Confere os pré-requisitos do sistema, os mesmos que o app e o instalador usam. Sem opções. Sai com o código 0 se tudo estiver presente e 1 se faltar algo.

Item	Requisito
Node.js	22+
git	qualquer versão
Python	3.10+
FFmpeg	5+
GitHub CLI	qualquer versão
Login no GitHub	`gh auth status` aprovado, para os repositórios privados

Se faltar algo, o comando mostra o instalador de uma linha do seu sistema:

Para instalar o que falta, rode o instalador:
  curl -fsSL https://harness.neuros.my/install.sh | bash

No Windows, a linha mostrada é irm https://harness.neuros.my/install.ps1 | iex.

neuro-harness engine

neuro-harness engine [versão]

Instala uma versão do motor neuro-mv-edit e aponta o comando neuro-mv-edit das sessões para ela. O motor vem do repositório privado, pela tag v<versão>.

Argumento	O que faz
`versão`	Versão do motor, sem o `v`. Padrão: a fixada da distribuição, 1.8.0

Onde fica: ~/.neuro-harness/engine/neuro-mv-edit/<versão>, com current apontando para a versão em uso.
Atalhos: recria neuro-mv-edit e neuro-mv-edit.cmd em ~/.neuro-harness/bin.

neuro-harness engine 1.8.0

✓ motor neuro-mv-edit v1.8.0

neuro-harness credenciais

neuro-harness credenciais [--dry-run] [--sobrescrever]

Importa chaves de API do Hermes e do OpenCode para o cofre do Harness (~/.neuro-harness/dsh/.credentials.yaml). Testa cada chave no próprio provedor e nunca mostra os valores. Também aceita o nome credentials.

Opção	O que faz
`--dry-run`	Testa as chaves e mostra o que gravaria, sem gravar
`--sobrescrever`	Troca as chaves que já estão no cofre. Sem a opção, elas ficam como estão

Arquivos lidos: ~/.hermes/.env, ~/.local/share/opencode/auth.json e ~/.config/opencode/meta-api-key.

Saída: a primeira linha mostra o caminho do cofre. Depois vem uma linha por provedor, com o resultado:

Resultado	Quando
Aceita	O provedor respondeu com HTTP 2xx. A chave é gravada
Recusada	O provedor respondeu com outro código, ou não respondeu. O código aparece na linha
Sem chave	Não há chave desse provedor no Hermes nem no OpenCode
Mantida	A referência já está no cofre e `--sobrescrever` não foi usado

A última linha é ✓ gravadas: <referências>, (simulação) gravaria: <referências> ou Nada a gravar.

Antes de gravar, o cofre é copiado para .credentials.yaml.bak. Os dois arquivos ficam legíveis só pelo seu usuário. Os logins OAuth não são importados.

neuro-harness credenciais --dry-run

A tabela de provedores e origens está em Provedores e chaves.

neuro-harness run

neuro-harness run "<tarefa>" [--modelo provedor/modelo]

Roda uma tarefa sem interface, com o perfil headless do Harness, os provedores do perfil neuro e o mesmo ambiente das sessões. A tarefa roda na pasta de trabalho. O comando sai com o código de saída do Harness.

Opção	O que faz
`--modelo provedor/modelo`	Modelo da tarefa, no formato `provedor/modelo`. Também aceita `--model`

A CLI grava a configuração da tarefa em ~/.neuro-harness/run.patch.yml.

neuro-harness run "Liste os perfis do neuro-mv-edit" --modelo kimi-coding/kimi-for-coding

neuro-harness version

neuro-harness version

Mostra a versão da distribuição. Também aceita --version e -v.

neuro-harness version

0.2.1

neuro-harness help

neuro-harness help

Mostra a lista de comandos, as versões do Neuro Harness e do DeepSeek Harness e as variáveis de ambiente. Também aceita --help e -h.