@neetru/cli

Developer Kit oficial da Neetru — scaffolding, IA Neetru-aware, deploy de produtos SaaS, gestão de workspaces, bancos isolados por produto, e mais 40+ comandos pra operar todo o ecossistema Neetru via terminal.

Instalação

npm install -g @neetru/cli

Bootstrap completo da máquina dev (Node, gcloud, Docker, Firebase CLI, deps NPM, GCP ADC):

neetru bootstrap

Login no Core via OAuth Device Code Flow:

neetru login

Validar estado:

neetru doctor

Quickstart — criar produto SaaS novo

neetru new gestovendas --env=dev --tier=dev --customer=neetru

Cria produto + workspace + scaffold local Next.js 15 + instala deps + abre cockpit no browser.

Comandos principais

| Comando | O que faz | |---|---| | neetru bootstrap | Setup da máquina dev (binários + deps + ADC) | | neetru login / logout / whoami | Auth OAuth Device Code Flow | | neetru doctor | Diagnóstico saúde (5 checks rápidos) | | neetru new <slug> | Criar produto completo (registry + workspace + scaffold) | | neetru init <name> | Só scaffold local Next.js + Firebase | | neetru add <feature> | Adicionar features ao scaffold (auth, billing, etc) | | neetru deploy | Pipeline de deploy interativo (cloud-run / vm / workspace) | | neetru build | Empacotar produto em tarball pra deploy | | neetru promote | Promover dev → staging → prod | | neetru env switch <target> | Trocar NEETRU_ENV no .env.local | | neetru env set --service=X --set KEY=VAL | Setar env vars de serviço Cloud Run | | neetru ar create <name> | Criar repositório Artifact Registry | | neetru hosting create-mapping --service=X --domain=Y | Domain mapping | | neetru db create --product=X --engine=postgres | Criar banco por produto | | neetru db engines | Listar engines disponíveis (firestore, postgres, mysql) | | neetru cloud-run pause/resume/delete <service> | Controle Cloud Run | | neetru products list/create/update | Registry de produtos | | neetru workspaces create/list/get/advance | Instâncias por cliente | | neetru deployments create/rollback | Histórico de deploys | | neetru tenants list/create/update/suspend | Gerenciar tenants | | neetru audit tail | Tail de audit_logs/ em tempo real | | neetru billing summary | Resumo de billing | | neetru servers list/provision/deactivate | Gerenciar servidores | | neetru agent release/yank/canary | Gerenciar releases do agente | | neetru support tickets list/reply/assign | Suporte inbox staff | | neetru dns zones list / hosting list | Listar DNS + customer domains | | neetru builds list | Listar Cloud Build | | neetru dr exports/restore | Disaster Recovery | | neetru logs | Ver logs de produtos | | neetru status | Visão geral do ecossistema | | neetru open <produto> | Abrir cockpit do produto no browser | | neetru ai | REPL IA Neetru-aware (Claude/OpenAI/Gemini) | | neetru ui | Menu interativo do CLI | | neetru publish | Publicar produto no catálogo público | | neetru fn deploy | Deploy de Cloud Functions | | neetru upgrade | Auto-update do CLI | | neetru autocomplete <bash\|zsh\|pwsh> | Gerar script autocomplete |

Atalhos: neetru ar = artifact-registry, neetru menu = ui.

40+ subcomandos. Quase todos suportam --json pra automação.

Configuração

Config persiste em ~/.config/neetru-cli/ (Linux/macOS) ou %APPDATA%\neetru-cli\ (Windows):

| Chave | Valor | |---|---| | neetruApiKey | Token Bearer nrt_<keyId>_<secret> (gerado por neetru login) | | coreUrl | URL base do Core (default https://core.neetru.com) | | telemetry.enabled | Telemetry opt-in (default false) |

neetru config set telemetry.enabled true
neetru config get coreUrl
neetru config path           # mostra caminho do config file

Output JSON

neetru products list --json | jq '.[] | select(.status == "ativo")'
neetru audit tail --json | jq 'select(.action | startswith("billing"))'

Auth & Segurança

• OAuth Device Code Flow (RFC 8628) pra login interativo — não armazena password
• Tokens salvos em conf cross-platform, permissões 0600 em Unix
• Rate-limit por método HTTP: GET 120/min, POST/PUT/PATCH 30/min, DELETE 5/min
• Step-up MFA (TOTP) obrigatório em operações destrutivas: --mfa-token <code> ou prompt
• Dry-run disponível em comandos de mutação: --dry-run mostra efeito SEM aplicar

Stack

• TypeScript 5 ESM-first
• Node 22+ (LTS)
• Sem node-fetch/axios: fetch global nativo
• Commander 11 (CLI framework) + Inquirer 12 (prompts) + Chalk 5 + Ora (spinners)

Mais info

• Repo: github.com/Neetru/neetru-core
• Docs: docs.neetru.com
• SDK complementar: npm install @neetru/sdk
• Issues / suporte: abrir issue no repo ou neetru support

Licença

MIT © Neetru