CLI de NaN.

NaN tiene una herramienta de terminal oficial, helmcode/nan-cli. Hace dos cosas: te enseña tu consumo real y configura tus herramientas de código por ti, sin que tengas que editar ficheros de configuración a mano.

Es un atajo, no un requisito. Todo lo que hace se puede hacer a mano siguiendo la página de tu herramienta en esta misma sección.

Qué configura sola

Para Claude Code, Cursor, VS Code, Cline y Zed sigue haciendo falta la configuración manual de sus páginas.

Solo lista las herramientas que tienes instaladas, y solo toca la parte de NaN de cada fichero: lo demás se queda como estaba, y desmarcar una herramienta vuelve a sacar lo nuestro. Hermes es la excepción a «escribe el fichero»: el CLI usa hermes config set, que es la forma que tiene Hermes de escribir su configuración, así que los comentarios del fichero sobreviven.

La key que pegas se comprueba contra el clúster antes de escribir nada, así que una mal copiada se ve ahí y no más tarde como un 401 dentro de cada herramienta.

Qué más te da

El CLI abre un panel con pestañas que se mueve con las flechas:

La pestaña Usage es la forma más rápida de saber cuánta cuota te queda antes de arrancar una sesión larga de agente.

Instalación

curl -fsSL https://nan.builders/install | bash

INSTALL_DIR="$HOME/.local/bin" curl -fsSL https://nan.builders/install | bash

irm https://nan.builders/install.ps1 | iex

& ([scriptblock]::Create((irm https://nan.builders/install.ps1))) -InstallDir "C:	ools"

nan --version

nan

opencode

git clone https://github.com/helmcode/nan-cli
cd nan-cli
go build -o nan .

mkdir -p ~/.local/bin
mv ./nan ~/.local/bin/nan

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Runs

Desde la v0.1.25 la CLI también pone a trabajar agentes en tareas dentro de tus workspaces, y los sigue desde tu terminal:

nan run "añade tests al parser de fechas y haz que pasen"
nan runs ls
nan runs logs <id> -f
nan run --byok-secret ANTHROPIC_KEY --model claude-sonnet-4-5 "arregla el test inestable"   # v0.1.32+, tu propia clave de proveedor

El run se ejecuta en el workspace, no en tu máquina, así que sigue aunque cierres la terminal. Los comandos de runs usan tu sesión de nan auth login, o un token de plataforma desde NAN_TOKEN, --token-file o nan auth login --api-token para scripts, CI y servidores. Todos los flags, el orden de autenticación, los códigos de salida y la API están en Runs de agentes.

Automatizaciones

Desde la v0.1.26 la CLI también lista y lanza tus automatizaciones, y te enseña las propuestas que esperan tu aprobación:

nan automations ls
nan automations run "PR review" --input '{"pr": 42}'
nan approvals ls
nan runs proposal <run-id>
nan runs reject <run-id>
nan secrets ls

Desde la v0.1.33, si tu cuenta tiene la API de escritura (se está abriendo poco a poco), la CLI también crea y cambia tus secretos, automatizaciones y triggers:

nan secrets set GITHUB_TOKEN --value-file ./token.txt     # lo añade, o reemplaza su valor
gh auth token | nan secrets set GITHUB_READ_TOKEN --value-stdin
nan secrets show GITHUB_TOKEN
nan secrets edit GITHUB_TOKEN --description "repo acme/api"
nan secrets rm OLD_TOKEN
nan automations create -f automation.yaml
nan automations edit "PR review" -f changes.yaml
nan automations disable "PR review"
nan automations triggers add "PR review" -f webhook.yaml  # imprime la URL y el secreto una vez

El valor de un secreto se lee de un archivo o de una tubería, nunca de la línea de comandos, y nada lo vuelve a imprimir. Todas las opciones de nan secrets, cómo rotar un secreto y los errores que puedes ver están en Secretos. Mientras tu cuenta no tenga la API de escritura, estos comandos te lo dicen y te mandan al portal. Aprobar propuestas siempre se hace en el portal, con sesión iniciada en tu navegador.

Desde la v0.1.34, donde tu cuenta tiene notificaciones, nan notifications gestiona los canales que te avisan en Slack, Microsoft Teams, Discord o tu propio endpoint cuando una automatización necesita tu aprobación o falla: nan notifications add "team alerts" --kind slack --url-file ./slack-url.txt, y luego nan notifications test "team alerts". La URL del webhook se lee de un archivo o de una tubería, nunca de la línea de comandos. Todos los comandos están en Notificaciones.

Estos comandos usan primero tu sesión de nan auth login (gana a NAN_TOKEN; --token-file gana a las dos), o un token de plataforma con los scopes que necesitan: secrets:read y secrets:write para secretos, automations:write (y automations:read para usar nombres) para automatizaciones; consulta Tokens para automatizaciones. Inicia sesión en tu propia máquina, nunca dentro de un workspace: los agentes de ahí podrían leer la sesión y cambiar tus secretos. Todos los comandos, los archivos YAML y los avisos están en Gestiónalas desde la CLI o la API.

Un run que espera aprobación hace que nan run, nan runs logs -f y nan automations run salgan con código 10. Los detalles están en Automatizaciones.

Actualizar

Vuelve a pasar el instalador. Siempre trae la última versión publicada y sobrescribe la que tengas:

curl -fsSL https://nan.builders/install | bash

Para quitarlo, borra el binario: rm /usr/local/bin/nan, o la ruta que le hayas dado con INSTALL_DIR. No deja nada más en tu sistema.

Si prefieres no instalar nada

Es completamente razonable. Ve directamente a la página de tu herramienta y copia el bloque de configuración:

• OpenCode
• Codex
• Claude Code
• Cursor
• VS Code y Copilot
• Cline
• Zed
• Otras herramientas

El resultado es el mismo. Lo único que te pierdes son las pestañas de consumo y costes.