CLI

A CLI da Nulvless gerencia seus projetos pelo terminal: environments, Edge Functions e suas secrets. Ela foi feita para ser usada por agentes de IA tanto quanto por pessoas, então todo comando tem modo JSON, códigos de saída previsíveis e erros que dizem como resolver.

Ela instala dois comandos equivalentes: nulvless e o mais curto nulv. O código é aberto em github.com/nulvless/cli.

Instalação

npm install --global nulvless

Requer Node.js 20 ou mais recente. Também dá para rodar sem instalar:

npx nulvless --help

Entrar

nulvless login

A CLI abre no navegador a tela de login e consentimento da Nulvless. Depois que você aprova, o navegador devolve a sessão para a CLI na sua própria máquina e o terminal confirma com qual conta você entrou.

A sessão fica no chaveiro do sistema: Keychain no macOS, Credential Manager no Windows ou Secret Service (GNOME Keyring, KWallet) no Linux. Onde não há chaveiro, ela vai para ~/.config/nulvless/session.json, legível só pelo seu usuário. O access token é renovado automaticamente.

nulvless whoami    # quem está logado e suas organizações
nulvless logout    # remove a sessão deste computador

Em CI

Defina NULVLESS_TOKEN com um access token. Ele tem prioridade sobre qualquer sessão salva, e a CLI nunca pergunta nada quando não está ligada a um terminal.

NULVLESS_TOKEN=… nulvless functions list --org acme --project shop --json

Escolher a organização e o projeto

Comandos que agem sobre um projeto precisam saber qual. A CLI procura nesta ordem:

Fora de um terminal não há lista para escolher, então um valor faltando vira um erro que diz qual flag passar.

Comandos

Environments

nulvless environments list
nulvless environments create staging --name "Staging"
nulvless environments delete staging

envs é um alias de environments. Excluir pede confirmação; passe --yes para pular.

Edge Functions

nulvless functions list
nulvless functions deployments checkout
nulvless functions delete checkout

fn é um alias de functions. deployments lista o histórico de deploys de uma função, do mais recente ao mais antigo.

Secrets

Secrets pertencem a uma Edge Function, então todo comando de secrets recebe --function.

nulvless secrets list --function checkout
nulvless secrets set STRIPE_SECRET_KEY --function checkout
nulvless secrets set STRIPE_SECRET_KEY=sk_live_… --function checkout
nulvless secrets unset STRIPE_SECRET_KEY --function checkout

• list mostra os nomes, nunca os valores.
• set KEY sem valor pede o valor sem exibi-lo, para ele não ficar no histórico do shell. Fora de um terminal, passe KEY=VALUE.
• Salvar ou remover uma secret faz um novo deploy da função com o novo valor.
• Nomes começando com NULVLESS_ ou NVL_, e EDGE_REGION, são reservados para valores que a Nulvless injeta. A CLI recusa esses nomes antes de enviar qualquer coisa.

Docs

nulvless docs                 # índice de todas as páginas
nulvless docs quickstart      # uma página em Markdown
nulvless docs sdk/auth > auth.md

docs imprime estas páginas em Markdown, o mesmo conteúdo do /llms.txt e dos links de Markdown de cada página deste site, para você salvar em arquivo ou mandar direto para o contexto de um agente.

Usar com um agente de IA

Agentes não clicam no navegador nem respondem perguntas, e precisam de uma saída que consigam ler. A CLI cobre cada um desses pontos:

• Docs no contexto. nulvless docs <path> entrega ao agente a API real em vez de um palpite.
• JSON em tudo. --json imprime os resultados em JSON no stdout. Quando um comando falha, o stderr recebe uma linha JSON: {"error":{"message":"…","hint":"…","exitCode":2}}.
• Sem perguntas. Fora de um terminal nada espera por entrada. Valores faltando falham dizendo qual flag passar, e comandos destrutivos exigem --yes.
• Erros com próximo passo. Todo erro traz uma dica, como Run `nulvless login` to sign in.

Adicione isto ao seu AGENTS.md, CLAUDE.md ou às regras do editor:

Use the Nulvless CLI (`npx nulvless`) to work with Nulvless.
Read the docs with `npx nulvless docs` and `npx nulvless docs <path>` before
writing integration code. Always pass `--json`, plus `--org` and `--project`.

Para prompts por funcionalidade, veja Vibe coding.

Opções globais

Variáveis de ambiente

Códigos de saída

Resultados vão para o stdout. Progresso, confirmações e erros vão para o stderr, então a saída em JSON pode ser encadeada com segurança.