CLI

keon é um cliente drop-in no formato neonctl para a plataforma Kisenon.

Instalar no macOS / Linux

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

Detecta sua plataforma, baixa o binário keon-<os>-<arch> correspondente, verifica o sha256 contra /dl/latest/manifest.json, e instala em /usr/local/bin (ou ~/.local/bin).

Instalar no Windows (PowerShell)

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

keon login
keon whoami

keon login executa um fluxo OAuth de loopback — sem colar chaves. Ele inicia um listener local em uma porta aleatória, abre seu navegador na página de autorização do console, e aguarda o redirecionamento. Após você autorizar, a CLI troca o code de uso único em POST /v1/cli/exchange por uma chave de API de vida longa com prefixo nsk_, com escopo na sua organização ativa.

A chave é persistida em ~/.config/keon/credentials.json com modo 0600. A CLI mantém apenas a chave resultante — nunca o code do OAuth, o state, ou qualquer token do provedor. keon logout revoga a chave no servidor e remove o arquivo; você também pode revogá-la a qualquer momento em Settings → API keys. Veja Autenticação para o fluxo completo.

Comandos comuns

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

Formato de saída

O padrão é JSON. Para tabelas: keon config set output table, ou passe --output table por comando.

Instalar a skill do Claude

keon install --skills

Coloca um SKILL.md + docs de referência em ./.claude/skills/keon/ para que um agente Claude possa operar a CLI sem um turno de configuração.

Solução de problemas

macOS: "developer cannot be verified"

Só acontece quando o binário foi baixado por um navegador com o atributo do Gatekeeper definido. Remova-o:

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

Windows: aviso do SmartScreen

Clique em "More info" → "Run anyway". Uma vez por máquina. Versões futuras podem assinar os binários; não na v0.1.

Abrir um bug

github.com/Seiraiyu/seiraiyu-neon/issues

On this page