neuroniun — o agente de terminal da IA Neuroniun

Executa na sua máquina o que chega da entidade de tarefas do Neuroniun (workflows, comandos de IA). Não é o N-Bash (esse é o neuroniundb, console do banco): este agente nunca faz login no NeuroniunDB. Ele fala só pela porta pública (POST /public), apresentando o token de uma bash — e o servidor faz tudo com autoridade de definer, escopada àquela bash. Quem usa o Neuroniun não ganha acesso ao banco.

Instalar

npm i -g neuroniun

Usar

neuroniun                 # abre o console: menu + tela ao vivo de cada bash
neuroniun --headless      # liga todas as bashes cadastradas, sem menu (serviço)
neuroniun --add <token>   # cadastra uma bash e sai (para scripts/instalação)
neuroniun --url <u>       # aponta para outro nó (padrão: api-neuroniun)

No console: a cola a chave de uma bash (gerada na tela Configurações → Bashes do app), um número abre a tela ao vivo daquela bash (q/Esc volta), r remove uma bash desta máquina, q sai. Suporta várias bashes ao mesmo tempo — cada uma é um worker próprio (estilo pm2), com seu poll (5 s), seu ping (5 min) e sua fila.

O que ele faz, por baixo

1. Liga a bash (nbx_ag_ligar) — informa host/SO/usuário; se a chave já estava ligada em outra máquina, esta toma.
2. Poll a cada 5 s (nbx_ag_proximo): pega o próximo comando da fila.
3. Executa com /bin/sh -c, com a permissão do usuário que instalou — qualquer comando, inclusive claude. Tempo máximo 10 min, saída até 1 MB.
4. Devolve a saída (nbx_ag_concluir): grava no histórico do dia e o comando some da fila.
5. Ping a cada 5 min (nbx_ag_ping): mantém o semáforo verde.

Estado local: ~/.neuroniun/bashes.json (modo 600) — url, instância, bash_id, nome e o segredo do token. Nada disso sai da máquina a não ser como o token, para o /public.

Segurança

• O agente não tem credencial do nó — só o token da bash. O token expira e pode ser revogado no app; revogado, o agente para de ligar.
• Roda com a autoridade da máquina onde foi instalado. É o modelo: você acessou a máquina e instalou, então pode rodar o que quiser nela.

Testes

npm test                          # unitário (fila falsa, sem rede)
NBX_INTEGRA=1 node test/integra_producao.mjs   # agente real contra produção

Backend e protocolo: flows/58-flow-nbx.snl e docs/SPEC-NEURONIUN-BASH.md.