CLI

keon es un cliente con forma de neonctl listo para usar con la plataforma Kisenon.

Instalar en macOS / Linux

curl -fsSL https://kisenon.com/install.sh | bash

Detecta su plataforma, descarga el binario keon-<os>-<arch> correspondiente, verifica el sha256 contra /dl/latest/manifest.json, e instala en /usr/local/bin (o ~/.local/bin).

Instalar en Windows (PowerShell)

iwr -useb https://kisenon.com/install.ps1 | iex

Primer inicio de sesión

keon login
keon whoami

keon login ejecuta un flujo OAuth de loopback — sin pegar claves. Inicia un escucha local en un puerto aleatorio, abre su navegador en la página de autorización de la consola, y espera la redirección. Después de que autorice, la CLI intercambia el código de un solo uso en POST /v1/cli/exchange por una clave de API de vida larga con prefijo nsk_, limitada a su organización activa.

La clave se persiste en ~/.config/keon/credentials.json con modo 0600. La CLI guarda solo la clave resultante — nunca el código OAuth, el estado ni ningún token del proveedor. keon logout revoca la clave del lado del servidor y elimina el archivo; también puede revocarla en cualquier momento desde Settings → API keys. Consulte Autenticación para el flujo completo.

Comandos comunes

keon projects list
keon branches list --project <id>
keon connection-string <branch> --project <id>

Formato de salida

El predeterminado es JSON. Para tablas: keon config set output table, o pase --output table por comando.

Instalar la skill de Claude

keon install --skills

Deja un SKILL.md + documentos de referencia en ./.claude/skills/keon/ para que un agente de Claude pueda manejar la CLI sin un turno de configuración.

Solución de problemas

macOS: "developer cannot be verified"

Solo ocurre cuando el binario se descargó mediante un navegador con el atributo de Gatekeeper puesto. Quítelo:

xattr -d com.apple.quarantine $(which keon)

Windows: advertencia de SmartScreen

Haga clic en "More info" → "Run anyway". Una vez por máquina. Las versiones futuras pueden firmar los binarios; no en la v0.1.

Reportar un error

github.com/Seiraiyu/seiraiyu-neon/issues