CLI nimu: todos os comandos

nimu status

nimu status

Mostra a máquina, se dá para publicar agora, os apps publicados, a máquina de produção e a cota da conta. É o primeiro comando a rodar antes de publicar ou de um deploy.

$ nimu status
Máquina ana-7k2p (sandbox): ligada
Editor: https://ana-7k2p.nimucloud.com
Publicar: 2 de 3 apps; dá para publicar (nimu publicar --porta 3000).
  k7m2p9xq  porta 3000  aberto a todos  no ar  https://k7m2p9xq.nimucloud.app
  w4n8t3hd  na produção  aberto a todos  no ar  https://w4n8t3hd.nimucloud.app  "loja"
Produção: máquina producao-kgx5, ligada (1 núcleo, 2 GB de memória, 10 GB de disco, conexão até 100 Mb/s). Apps nela: 1 de até 3.
  Reiniciar: nimu producao reiniciar (os apps ficam fora do ar por cerca de 1 minuto). Apagar: nimu producao apagar (só com a máquina vazia).
Cota da conta: máquinas de produção 1 de 1; apps publicados 2 de 3.

Numa conta que ainda não publicou nada, a resposta diz o que cria a máquina de produção:

$ nimu status
Máquina ana-7k2p (sandbox): ligada
Editor: https://ana-7k2p.nimucloud.com
Publicar: 0 de 3 apps; dá para publicar (nimu publicar --porta 3000).
Produção: nenhuma máquina ainda. A primeira versão (nimu deploy), o primeiro segredo ou o primeiro banco cria a máquina de produção da conta, e ela conta na cota.
Cota da conta: máquinas de produção 0 de 1; apps publicados 0 de 3.

Em JSON, a mesma resposta traz publicar.pode_publicar, publicar.falta (o que impede de publicar), apps com a conferência da porta em porta_local, e producao com a máquina, a cota e os apps que ocupam lugar nela:

$ nimu status --json
{
  "ok": true,
  "maquina": {
    "slug": "ana-7k2p",
    "produto": "sandbox",
    "estado": "ligada",
    "url": "https://ana-7k2p.nimucloud.com"
  },
  "publicar": {
    "dominio": "nimucloud.app",
    "limite": 3,
    "pode_publicar": true,
    "falta": ""
  },
  "apps": [
    {
      "id": 3,
      "nome": "k7m2p9xq",
      "rotulo": "",
      "url": "https://k7m2p9xq.nimucloud.app",
      "porta": 3000,
      "visibilidade": "publico",
      "estado": "ativo",
      "situacao": "no_ar",
      "motivo": "",
      "criado_em": "2026-10-08T17:02:11Z",
      "destino": "sandbox",
      "porta_local": {
        "ok": true,
        "porta": 3000,
        "situacao": "escuta_em_todos",
        "alcancavel": true,
        "enderecos": [
          "0.0.0.0"
        ],
        "programa": "node",
        "publicavel": true,
        "mensagem": "a porta 3000 está pronta: o node escuta em 0.0.0.0, e a borda da Nimu chega nele"
      }
    }
  ],
  "producao": {
    "maquina": null,
    "cota": {
      "producao": 1,
      "producao_uso": 0,
      "apps": 3,
      "apps_uso": 1
    },
    "apps_na_maquina": [],
    "limite_apps_maquina": 3
  }
}

nimu apps

nimu apps

Lista os apps publicados da conta: o id, onde roda, quem abre, a situação e o endereço. Quando a porta de um app da Sandbox não está pronta nesta máquina, a linha de baixo avisa.

$ nimu apps
Apps publicados (2 de 3):
  k7m2p9xq  porta 3000  com senha  no ar  https://k7m2p9xq.nimucloud.app
      atenção: nada escuta na porta 3000 agora
  w4n8t3hd  na produção  aberto a todos  no ar  https://w4n8t3hd.nimucloud.app  "loja"

Sem nenhum app, a resposta é "Nenhum app publicado. Para publicar a porta 3000: nimu publicar --porta 3000".

nimu app

nimu app ID [--porta N] [--aberto | --senha S | --senha-stdin | --gerar-senha] [--rotulo T]

Sem opções, mostra um app. Com opções, muda a porta, quem abre, a senha ou o nome no painel. O endereço não muda.

$ nimu app k7m2p9xq
k7m2p9xq: https://k7m2p9xq.nimucloud.app
  porta 3000, aberto a todos, no ar
  nesta máquina: a porta 3000 está pronta: o node escuta em 0.0.0.0, e a borda da Nimu chega nele
$ nimu app k7m2p9xq --porta 8000
Pronto: https://k7m2p9xq.nimucloud.app (porta 8000, aberto a todos).

Mudar a porta, pôr senha, trocar a senha e trocar o nome valem na hora. Tirar a senha, com --aberto, espera a sua confirmação no painel:

$ nimu app m4rk9t2q --aberto
Pedido enviado: confirme no painel em https://nimucloud.com/painel/#/confirmar/1. O app continua com senha até a confirmação.

nimu porta

nimu porta N

Confere se o app da porta N está pronto para publicar: quem escuta nela e em qual endereço. Olha só esta máquina, sem falar com a Nimu. O código de saída é 1 quando a Nimu não chegaria na porta.

$ nimu porta 3000
A porta 3000 está pronta: o node escuta em 0.0.0.0, e a borda da Nimu chega nele.
$ nimu porta 5173
A porta 5173 escuta só em 127.0.0.1 (localhost): a borda da Nimu não chega nela.
Reinicie o app escutando em 0.0.0.0. Vite: npm run dev -- --host 0.0.0.0 (ou server.host: true no vite.config). No Vite, ponha também '.nimucloud.app' em server.allowedHosts.
$ nimu porta 3001
Nada escuta na porta 3001 agora.
Suba o app nessa porta escutando em 0.0.0.0 (por exemplo: npm run dev -- --host 0.0.0.0 --port 3001) e confira de novo com nimu porta 3001.

Em JSON, alcancavel diz se a porta está pronta, e situacao é uma destas: escuta_em_todos, ip_da_maquina, so_localhost, outro_endereco ou ninguem_escutando.

$ nimu porta 5173 --json
{
  "ok": true,
  "porta": 5173,
  "situacao": "so_localhost",
  "alcancavel": false,
  "enderecos": [
    "127.0.0.1"
  ],
  "programa": "node",
  "publicavel": true,
  "mensagem": "a porta 5173 escuta só em 127.0.0.1 (localhost): a borda da Nimu não chega nela",
  "dica": "Reinicie o app escutando em 0.0.0.0. Vite: npm run dev -- --host 0.0.0.0 (ou server.host: true no vite.config). No Vite, ponha também '.nimucloud.app' em server.allowedHosts."
}

nimu publicar

nimu publicar --porta N [--senha S | --senha-stdin | --gerar-senha] [--rotulo T]

Publica a porta num endereço com HTTPS, https://<id>.nimucloud.app. Sem opção de senha, o app fica aberto a todos. nimu publicar 3000, com a porta solta, também vale.

$ nimu publicar --porta 3000
Publicado em https://k7m2p9xq.nimucloud.app (porta 3000, aberto a todos). O endereço começa a responder em alguns segundos.
$ nimu publicar --porta 4000 --gerar-senha
Publicado em https://m4rk9t2q.nimucloud.app (porta 4000, com senha). O endereço começa a responder em alguns segundos.
Senha: Xq7mK2pR9tWv4nHd  (guarde agora: ela não aparece de novo)

--porta N

A porta em que o app escuta, de 1024 a 65535, menos 8080, 9119, 9120, 9121 e 9200.

--senha S

A senha do app, de 8 a 72 caracteres.

--senha-stdin

Lê a senha da entrada, sem mostrar na tela.

--gerar-senha

Sorteia a senha, de 16 letras, e mostra uma vez.

--rotulo T

Um nome de até 40 caracteres para reconhecer o app no painel.

Se a porta não estiver pronta, o comando publica assim mesmo e põe na frente uma linha "Atenção:". O passo a passo está em Publicar.

nimu remover

nimu remover ID [--sim]

Pede para tirar o app do ar de vez. O endereço não volta. Se o app está na produção, saem junto os segredos e o banco dele. A remoção só acontece depois da sua confirmação no painel.

$ nimu remover k7m2p9xq --sim
Pedido enviado: confirme no painel em https://nimucloud.com/painel/#/confirmar/1. O app continua no ar até a confirmação.

Sem --sim, o terminal pergunta antes. Fora do terminal, ou com --json, o comando recusa: "remover tira o app do ar de vez (o endereço não volta); confirme com --sim". Em JSON, o pedido que espera a pessoa sai como a Nimu respondeu:

$ nimu remover k7m2p9xq --sim --json
{
  "ok": true,
  "situacao": "aguardando_confirmacao",
  "confirmacao": {
    "id": 1,
    "acao": "remover_app",
    "confirmar_em": "https://nimucloud.com/painel/#/confirmar/1"
  }
}

nimu iniciar

nimu iniciar [--tipo auto|node|vite|next|python|estatico] [--porta N] [--banco] [--sobrescrever] [--pasta P]

Prepara o projeto para a produção: escreve o Dockerfile, o .dockerignore e o nimu.toml. Não troca o que já existe, a menos que você use --sobrescrever. Só mexe na pasta do projeto.

$ nimu iniciar
Projeto Node.js em /home/dev/projetos/loja (package.json).
  Dockerfile     criado
  .dockerignore  criado
  nimu.toml      criado
A produção roda o contêiner com o app escutando em 0.0.0.0:3000, a saúde em / e 256 MB de memória (nimu.toml).
Atenção: O .env fica fora da imagem (.dockerignore): ponha os segredos da produção com nimu segredo definir.
Confira o Dockerfile e publique: nimu deploy --novo (constrói aqui e manda para a produção; acompanhe com nimu versoes ID).

Os tipos de projeto e o nimu.toml estão em Produção.

nimu deploy

nimu deploy [--app ID | --novo] [--porta N] [--saude /] [--memoria 256] [--esperar] [--pasta P]

Constrói a imagem do projeto na Sandbox e publica uma versão nova na produção. Volta logo, com o número da versão: acompanhe com nimu versoes ID. A primeira versão da conta cria a máquina de produção.

$ nimu deploy
Construindo a imagem (docker build).
Salvando e comprimindo a imagem (docker save | zstd).
Abrindo a entrega para a Nimu buscar a imagem (porta 9121).
Versão 4 de w4n8t3hd na fila (imagem de 87,0 MB). A Nimu busca a imagem, confere e sobe; acompanhe com: nimu versoes w4n8t3hd

--novo

Cria o app de produção, aberto a todos, e grava o id no nimu.toml. É para a primeira vez.

--app ID

Manda a versão para este app. Sem a opção, vale o app do nimu.toml.

--porta N

A porta do app dentro do contêiner. Sem a opção, a do nimu.toml.

--saude /

O caminho que responde quando o app está pronto. Sem a opção, o do nimu.toml, ou /.

--memoria 256

O limite de memória do contêiner, de 128 a 1024 MB.

--esperar

Espera a versão ficar no ar, falhar ou ser bloqueada, por até 10 minutos depois da construção.

--pasta P

A pasta do projeto.

Em JSON, situacao vem na_fila, com o número em versao, ou construindo, quando a construção passou de 90 segundos e continua em segundo plano. Quando a versão criou a máquina de produção, vem também maquina_criada. O registro da construção fica em ~/.local/state/nimu/deploy-ID.log.

A primeira versão, o --esperar e as recusas estão em Produção.

nimu producao

nimu producao | nimu producao reiniciar [--sim] | nimu producao apagar [--sim]

Sozinho, mostra a máquina de produção da conta: o nome, o estado, o tamanho, os apps nela e a cota. Com reiniciar, reinicia a máquina. Com apagar, apaga a máquina vazia.

$ nimu producao
Produção: máquina producao-kgx5, ligada (1 núcleo, 2 GB de memória, 10 GB de disco, conexão até 100 Mb/s). Apps nela: 1 de até 3.
  w4n8t3hd  na produção  aberto a todos  no ar  https://w4n8t3hd.nimucloud.app  "loja"
Cota da conta: máquinas de produção 1 de 1; apps publicados 2 de 3.
Reiniciar: nimu producao reiniciar (os apps ficam fora do ar por cerca de 1 minuto). Apagar: nimu producao apagar (só com a máquina vazia).
$ nimu producao reiniciar --sim
Máquina de produção producao-kgx5 reiniciando: os apps dela ficam fora do ar por cerca de 1 minuto e voltam sozinhos. Acompanhe com: nimu producao

Apagar só vale com a máquina vazia. Com app nela, o comando recusa e pede para remover os apps antes. Vazia, a resposta é esta:

$ nimu producao apagar --sim
Máquina de produção producao-kgx5 saindo do servidor: ela já não conta na cota da conta. A próxima versão publicada (nimu deploy) cria outra.

Sem --sim, o terminal pergunta antes. Fora do terminal, ou com --json, o comando pede o --sim. Essas duas ações não passam pela confirmação no painel.

nimu versoes

nimu versoes ID [--versao N]

Lista as versões do app na produção, da mais nova para a mais velha, e a construção que ainda estiver em andamento na Sandbox. Com --versao N, mostra uma versão só, com o erro, os bloqueios e as últimas linhas do app.

$ nimu versoes w4n8t3hd
Versões de w4n8t3hd (https://w4n8t3hd.nimucloud.app):
  v3   ativa        criada 2026-10-08 15:00, no ar desde 2026-10-08 15:01
  v2   substituida  criada 2026-10-08 10:00, no ar desde 2026-10-08 10:02
  v1   substituida  criada 2026-10-07 17:00, no ar desde 2026-10-07 17:02
Detalhes de uma versão: nimu versoes w4n8t3hd --versao N. Voltar a uma: nimu voltar w4n8t3hd --versao N
$ nimu versoes w4n8t3hd --versao 3
Versão 3 de w4n8t3hd: no ar.
  criada 2026-10-08 15:00, no ar desde 2026-10-08 15:01

As situações de uma versão estão em Produção.

nimu voltar

nimu voltar ID --versao N

Volta o app para uma versão anterior, em segundos. Troca só a imagem: o banco fica como está, e a migração feita não é desfeita.

$ nimu voltar w4n8t3hd --versao 2
Pedido na fila: w4n8t3hd volta para a versão 2 em instantes (só a imagem; o banco fica como está, e a migração feita não é desfeita). Acompanhe com: nimu versoes w4n8t3hd

nimu logs

nimu logs ID [--linhas 200] [--seguir]

Mostra as últimas linhas que o app escreveu na produção. --linhas vai de 1 a 200, e sem a opção vêm 200. --seguir continua mostrando as linhas novas até Ctrl+C, e não combina com --json.

$ nimu logs w4n8t3hd --linhas 3
servidor no ar em 0.0.0.0:3000
GET / 200
GET /saude 200

A primeira chamada pede os logs à produção e espera alguns segundos por eles. Se o app ainda não escreveu nada, a resposta é "O app não escreveu nada ainda."

nimu segredo

nimu segredo definir ID NOME | nimu segredo remover ID NOME

Define ou remove um segredo do app na produção. O valor entra pela entrada, nunca como argumento: no terminal, ele é pedido sem aparecer na tela.

$ nimu segredo definir w4n8t3hd STRIPE_SECRET_KEY
Valor de STRIPE_SECRET_KEY (não aparece na tela; Enter para terminar):
Segredo STRIPE_SECRET_KEY do app w4n8t3hd a caminho da produção (na fila): o valor saiu cifrado para a Nimu e não aparece em lugar nenhum. Com o app no ar, a produção reinicia o app em cerca de 1 min, já com o valor novo (não precisa publicar de novo).
$ nimu segredo remover w4n8t3hd STRIPE_SECRET_KEY
Pedido enviado: confirme no painel em https://nimucloud.com/painel/#/confirmar/1. Até lá, os segredos do app ficam como estão; o pedido vale por 2 h.

Um segredo novo vale na hora. Trocar o valor de um que já existe e remover esperam a sua confirmação no painel. As regras do nome e do valor estão em Segredos.

nimu segredos

nimu segredos ID

Lista os nomes dos segredos do app na produção, com a data da última mudança. Os valores nunca saem.

$ nimu segredos w4n8t3hd
Segredos de w4n8t3hd (só os nomes; os valores nunca saem da produção):
  STRIPE_SECRET_KEY  (atualizado 2026-10-08 14:02)

nimu banco

nimu banco [ID] | nimu banco criar [ID] | nimu banco restaurar ID COPIA [--sim] | nimu banco apagar ID [--sim] | nimu banco dev [--pasta P]

Cuida do Postgres do app na produção. Sem o ID, nimu banco e nimu banco criar valem para o app do nimu.toml da pasta atual.

nimu banco ID

Mostra a situação, o tamanho, o limite da conta e as cópias.

nimu banco criar ID

Pede o banco do app, sem publicar uma versão.

nimu banco restaurar ID COPIA

Pede para restaurar uma cópia. Espera a sua confirmação no painel.

nimu banco apagar ID

Pede para apagar o banco. Espera a sua confirmação no painel.

nimu banco dev

Sobe um Postgres local na Sandbox, para desenvolver, e grava o DATABASE_URL no .env do projeto.

$ nimu banco w4n8t3hd
w4n8t3hd não tem banco. Para criar: nimu banco criar w4n8t3hd, ou banco = true no nimu.toml e nimu deploy (o deploy cria o banco antes de ativar).
A conta usa 0 bytes de 1,0 GB nos bancos.

Com o banco pronto, a resposta lista as cópias:

$ nimu banco w4n8t3hd
Banco de w4n8t3hd: pronto (app_w4n8t3hd), 12,3 MB, criado 2026-10-07 13:00.
  conta: 12,3 MB de 1,0 GB nos bancos (passando disso, o deploy é recusado até sobrar espaço)
  Postgres da máquina de produção: ligado
  cópias na máquina de produção (restaurar: nimu banco restaurar w4n8t3hd ID):
    20261008-1502-deploy         deploy    2026-10-08 18:02  1,1 MB
    20261008-0300-diaria         diaria    2026-10-08 06:00  1,0 MB
  fora de casa: 2 cópias cifradas (ficam 15 dias); a última, 20261008-0300-diaria, enviada 2026-10-08 07:00

As respostas de criar, restaurar, apagar e do nimu banco dev estão em Banco de dados.

nimu navegador

nimu navegador [status | mcp | ligar | parar | abas]

Cuida do navegador do agente, o Chromium que fica ligado dentro da Sandbox.

nimu navegador

O mesmo que status: diz se está ligado, a versão do navegador, as abas abertas e como ver a tela no painel.

nimu navegador abas

Lista as abas abertas, com o título e o endereço.

nimu navegador parar

Desliga o navegador. As abas fecham, e os logins ficam guardados.

nimu navegador ligar

Liga de novo e espera ele responder.

nimu navegador mcp

É o que os agentes rodam para usar a ferramenta navegador. Liga o navegador, se for preciso.

$ nimu navegador abas
  Minha loja  http://localhost:3000/
  (sem título)  about:blank
$ nimu navegador parar
Navegador da Nimu desligado: o agente fica sem o navegador até ligar de novo (nimu navegador ligar; o nimu navegador mcp também liga sozinho quando o agente abre). As abas fecharam; os logins ficam no perfil.

nimu configurar-agentes

nimu configurar-agentes [--simular]

Liga as ferramentas nimu e navegador no Claude Code, no Codex, no Gemini CLI e no OpenCode do usuário, e grava o bloco de instruções da Nimu. A Sandbox já vem com isso feito: rode de novo só se um agente perdeu a configuração.

$ nimu configurar-agentes
Agentes de dev (/home/dev):
  ok       claude-mcp (~/.claude.json)
  ok       claude-navegador (~/.claude.json)
  ok       claude-instrucoes (~/.claude/CLAUDE.md)
  ok       codex-execucao (~/.codex/config.toml)
  ok       codex-mcp (~/.codex/config.toml)
  ok       codex-navegador (~/.codex/config.toml)
  ok       codex-instrucoes (~/.codex/AGENTS.md)
  ok       gemini-mcp (~/.gemini/settings.json)
  ok       gemini-navegador (~/.gemini/settings.json)
  ok       gemini-instrucoes (~/.gemini/GEMINI.md)
  ok       opencode-mcp (~/.config/opencode/opencode.json)
  ok       opencode-navegador (~/.config/opencode/opencode.json)
  ok       opencode-instrucoes (~/.config/opencode/AGENTS.md)
  ok       projetos-instrucoes (~/projetos/AGENTS.md)
Nada mudou: os agentes já estavam configurados.

Cada linha diz o que aconteceu com um arquivo: ok (já estava), mudou, mudaria (com --simular, que não grava nada), pulei ou falhou. O comando só acrescenta as entradas da Nimu: o resto de cada arquivo fica como estava, e uma entrada que já existe não é trocada. Depois de uma mudança, feche e abra o agente.

nimu mcp

nimu mcp

Sobe um servidor MCP pela entrada e pela saída do processo, com as mesmas ações da CLI. É o comando que os agentes rodam por baixo: você não precisa chamar à mão. Para ver as ferramentas que ele oferece:

$ printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | nimu mcp

A resposta é uma linha de JSON com as 21 ferramentas. Elas estão descritas em MCP para agentes.

nimu entregar

nimu entregar ARQUIVO --token T [--prazo 10m] [--apagar]

Põe um arquivo na fila das entregas: a Nimu busca uma vez, pela porta 9121 da Sandbox, e depois o arquivo sai da fila. É o mecanismo que o nimu deploy e o nimu segredo usam por baixo. No dia a dia, você não roda este comando.

$ nimu entregar imagem.tar.zst --token "$TOKEN" --prazo 10m
Entrega pronta na porta 9121: a Nimu busca uma vez, até 15:42; depois, o arquivo sai da fila.

--token T

O token de uso único da entrega, de 16 a 128 letras, números, - e _. Sem a opção, vale a variável NIMU_ENTREGA_TOKEN.

--prazo

Quanto a entrega espera ser buscada, de 1 segundo a 2 horas. Sem a opção, 1 hora.

--apagar

Apaga o arquivo original depois de pô-lo na fila.

O arquivo pode ter até 2 GB. Só a Nimu alcança a porta 9121.

nimu atualizar

nimu atualizar

Baixa a versão mais nova da CLI, confere o sha256 e a assinatura da Nimu e só então troca o programa. Se algo não confere, nada é trocado.

$ nimu atualizar
A CLI já está na versão mais recente (20261009.0025).

Quando há versão nova, a resposta diz a de antes e a de agora. Os agentes abertos passam a usar a nova quando forem reiniciados.

nimu versao

nimu versao

Mostra a versão da CLI instalada.

$ nimu versao
nimu 20261009.0025, linux/amd64

nimu ajuda

nimu ajuda

Lista todos os comandos, cada um com o uso e uma frase. Com o nome de um comando, mostra só ele. nimu sem nada e nimu --help fazem o mesmo.

$ nimu ajuda remover
uso: nimu remover ID [--sim]
tira o app do ar de vez (o endereço não volta; na produção, saem junto os segredos e o banco do app)