CLI

keon es un cliente drop-in con forma de neonctl para la plataforma Kisenon.

Instalar en macOS / Linux

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

Detecta tu 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

El canal principal es winget:

winget install Seiraiyu.Keon

O ejecuta el script de instalación directamente:

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

Primer inicio de sesión

keon login
keon me

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

La clave se persiste en ~/.config/keon/credentials.json con modo 0600. La CLI conserva únicamente 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 puedes revocarla en cualquier momento desde Settings → API keys. Consulta Autenticación para el flujo completo.

Comandos comunes

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

Eliminar un proyecto también elimina sus ramas y endpoints — pasa --cascade, o la API devuelve 409 has_branches:

keon projects delete <id> --cascade

El mismo flag --cascade se aplica a keon branches delete <id>.

Flujos de trabajo de agentes

keon cubre la superficie segura para agentes, no solo proyectos y ramas:

• keon sandbox — impulsa sandboxes de agentes: entornos de base de datos efímeros de captura-y-promoción para agentes.
• keon ledger — lee el ledger de promociones y verifica las atestaciones de captura/promoción.
• keon ip-allow — gestiona la lista de permitidos de IP de un proyecto.

Otros comandos de nivel superior incluyen orgs, endpoints, databases, roles, snapshots, operations, usage y audit. Ejecuta keon --help para el conjunto completo.

Formato de salida

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

Instalar la skill de Claude

keon install --skills

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

Solución de problemas

macOS: "developer cannot be verified"

Solo ocurre cuando el binario se descargó a través de un navegador con el atributo de Gatekeeper establecido. Quítalo:

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

Windows: advertencia de SmartScreen

Haz clic en "More info" → "Run anyway". Una vez por máquina. Instalar mediante winget install Seiraiyu.Keon evita el aviso. (Los binarios de macOS están firmados y notarizados; la reputación de SmartScreen en las compilaciones de Windows crece con el tiempo.)

Reportar un error

github.com/Seiraiyu/seiraiyu-neon/issues