CLI

keon은 Kisenon 플랫폼을 위한 드롭인 neonctl 형태 클라이언트입니다.

macOS / Linux에 설치

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

플랫폼을 감지하고, 일치하는 keon-<os>-<arch> 바이너리를 다운로드하며, /dl/latest/manifest.json에 대해 sha256을 검증하고, /usr/local/bin(또는 ~/.local/bin)에 설치합니다.

Windows에 설치 (PowerShell)

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

첫 로그인

keon login
keon whoami

keon login은 루프백 OAuth 플로우를 실행합니다 — 키를 붙여 넣지 않아도 됩니다. 임의의 포트에서 로컬 리스너를 시작하고, 브라우저에서 콘솔의 인증 페이지를 열며, 리디렉션을 기다립니다. 인증하면 CLI가 일회성 코드를 POST /v1/cli/exchange에서 활성 조직으로 범위가 지정된 수명이 긴 nsk_ 접두사 API 키로 교환합니다.

키는 ~/.config/keon/credentials.json에 모드 0600으로 저장됩니다. CLI는 결과로 나온 키만 유지합니다 — OAuth 코드, state, 또는 제공자 토큰은 절대 보관하지 않습니다. keon logout은 서버 측에서 키를 폐기하고 파일을 제거합니다. 설정 → API 키에서도 언제든지 폐기할 수 있습니다. 전체 플로우는 인증을 참조하세요.

자주 쓰는 명령

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

출력 형식

기본값은 JSON입니다. 테이블의 경우: keon config set output table을 사용하거나, 명령별로 --output table을 전달하세요.

Claude 스킬 설치

keon install --skills

./.claude/skills/keon/에 SKILL.md + 참조 문서를 떨어뜨려 Claude 에이전트가 설정 단계 없이 CLI를 구동할 수 있게 합니다.

문제 해결

macOS: "developer cannot be verified"

Gatekeeper 속성이 설정된 채 브라우저로 바이너리를 다운로드한 경우에만 발생합니다. 다음으로 속성을 제거하세요:

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

Windows: SmartScreen 경고

"More info" → "Run anyway"를 클릭하세요. 머신당 한 번입니다. 향후 릴리스는 바이너리에 서명할 수도 있지만, v0.1에는 없습니다.

버그 신고

github.com/Seiraiyu/seiraiyu-neon/issues

On this page