CLI

A CLI do Nodaro (@nodaro/cli) é um cliente de linha de comando para o Nodaro. Ela lista e executa workflows, executa apps publicados, executa um único nó sem workflow e acompanha cada execução até o fim. Ela mantém vários perfis conectados lado a lado e imprime JSON para scripts, então se encaixa no trabalho no terminal, em jobs do cron e em pipelines de CI.

A CLI é uma camada fina sobre o SDK para TypeScript. Para uma integração escrita em código, use o SDK diretamente.

Instalação

npm install -g @nodaro/cli
nodaro --version

npx @nodaro/cli projects list

# 1. The newest CLI version
NODARO_CLI_VERSION=$(curl -fsSL "https://api.github.com/repos/nodaroai/app.nodaro.ai/git/matching-refs/tags/cli-v?per_page=100" \
  | grep -o '"refs/tags/cli-v[0-9][0-9.]*"' | tr -d '"' | sed 's#refs/tags/cli-v##' \
  | sort -t. -k1,1n -k2,2n -k3,3n | tail -n 1)
echo "Installing @nodaro/cli $NODARO_CLI_VERSION"

# 2. Your platform: darwin-arm64 (Apple silicon), darwin-x64 (Intel Mac), linux-x64 or linux-arm64
NODARO_CLI_PLATFORM=darwin-arm64

# 3. Download. -f fails on an HTTP error instead of saving the error page as the binary.
curl -fL "https://github.com/nodaroai/app.nodaro.ai/releases/download/cli-v$NODARO_CLI_VERSION/nodaro-$NODARO_CLI_PLATFORM" \
  -o /usr/local/bin/nodaro && chmod +x /usr/local/bin/nodaro
nodaro --version

$v = (Invoke-RestMethod "https://api.github.com/repos/nodaroai/app.nodaro.ai/git/matching-refs/tags/cli-v?per_page=100") |
  ForEach-Object { $_.ref -replace '^refs/tags/cli-v', '' } |
  Where-Object { $_ -match '^\d+\.\d+\.\d+$' } |
  Sort-Object { [version]$_ } | Select-Object -Last 1
Invoke-WebRequest "https://github.com/nodaroai/app.nodaro.ai/releases/download/cli-v$v/nodaro-windows-x64.exe" -OutFile nodaro.exe
.\nodaro.exe --version

Para fixar uma versão, pule a primeira etapa e defina a versão você mesmo. Todas as releases da CLI e os binários delas estão listados nas releases cli-v do repositório público.

Login

A CLI se autentica com um token de API pessoal e o salva em um perfil.

Se o fluxo no navegador falhar, a CLI pede que você cole um token. Para criar um token você mesmo, abra Configurações › Tokens de API no Nodaro e clique em Criar token. O token completo é mostrado uma única vez. Os tokens de API pessoais estão disponíveis no Nodaro Cloud e nas instalações da Business edition. Leia Autenticação para entender como os tokens funcionam.

nodaro auth login                                   # browser sign-in
nodaro auth login --no-browser                      # paste a token instead
nodaro auth login --token "$NODARO_TOKEN"           # non-interactive, for CI
nodaro auth status [--profile <name>] [--json]      # show a profile, token masked
nodaro auth logout [--profile <name>]               # delete a saved profile

A CLI guarda os perfis em ~/.config/nodaro/config.json, que só o seu usuário pode ler (modo de arquivo 0600). Defina NODARO_CONFIG_DIR para guardar o arquivo em outra pasta.

Perfis para várias instâncias

Um perfil é um endereço de instância e um token salvos. Crie um perfil por instância, como o Nodaro Cloud, uma instalação de staging e uma instalação local. Depois, escolha um com --profile, que todos os comandos aceitam:

nodaro auth login --profile prod    --base-url https://app.nodaro.ai
nodaro auth login --profile staging --base-url https://staging.example.com
nodaro auth login --profile local   --base-url http://localhost:3000

nodaro projects list --profile staging

Um comando sem --profile usa o perfil padrão. O padrão é production até você salvar um perfil: o primeiro perfil que você salvar passa a ser o padrão. Por isso, um único nodaro auth login, sem flags, é tudo de que a maioria das pessoas precisa.

Escolher um espaço de trabalho

Em uma instância com organizações, o trabalho fica em espaços de trabalho. Escolha um para um único comando com --workspace <id>, para um shell ou um job de CI com NODARO_WORKSPACE, ou salve um no perfil com nodaro workspace use <id>. Sem nenhum definido, o trabalho acontece no seu espaço pessoal. Veja Espaços de trabalho e organizações.

Três formas de executar

A CLI cobre as três formas de execução do Nodaro. Escolha a que corresponde ao que você criou.

nodaro nodes run é o equivalente, na CLI, das ferramentas de ação do servidor MCP, como generate_image e generate_video. Todo nó de geração responde em POST /v1/<type>, então qualquer nó que nodaro nodes list mostra pode ser executado com nodaro nodes run. Veja Executar um único nó para o lado REST.

Adicione --watch para aguardar até a execução terminar:

nodaro nodes run generate-image \
  --param prompt="a snow leopard on a mountain ridge, cinematic" \
  --param provider=flux \
  --watch

Leia Parâmetros e arquivos de entrada para a sintaxe de --param, e Saída e códigos de saída antes de usar a CLI em scripts.

O que a CLI não cobre

A CLI deixa de fora créditos, apps de desenvolvedor, OAuth, pipelines, Reduce e os auxiliares de upload. Para esses recursos, use o SDK ou a API REST.

Passar da CLI para o código é rápido. Este é o equivalente no SDK de nodaro workflows run wf_abc:

import { createClient, StaticTokenAuth } from "@nodaro/sdk"

const nodaro = createClient({
  baseUrl: "https://app.nodaro.ai",
  auth: new StaticTokenAuth(process.env.NODARO_TOKEN!),
})

const run = await nodaro.workflows.run("wf_abc")

Próximos passos