CLI
Kisenon 플랫폼을 위한 드롭인 neonctl 형태 클라이언트.
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에 설치
기본 채널은 winget입니다:
winget install Seiraiyu.Keon또는 설치 스크립트를 직접 실행하세요:
iwr -useb https://kisenon.com/install.ps1 | iex첫 로그인
keon login
keon mekeon 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>프로젝트를 삭제하면 그 브랜치와 엔드포인트도 삭제됩니다 — --cascade를
전달하세요. 그렇지 않으면 API가 409 has_branches를 반환합니다:
keon projects delete <id> --cascade동일한 --cascade 플래그가 keon branches delete <id>에도 적용됩니다.
에이전트 워크플로
keon은 프로젝트와 브랜치뿐 아니라 에이전트 안전 표면을 다룹니다:
keon sandbox— 에이전트 샌드박스를 구동합니다: 에이전트를 위한 임시 캡처 앤 프로모트 데이터베이스 환경.keon ledger— 프로모트 원장을 읽고 캡처/프로모트 증명을 검증합니다.keon ip-allow— 프로젝트의 IP 허용 목록을 관리합니다.
다른 최상위 명령으로는 orgs, endpoints, databases, roles,
snapshots, operations, usage, 그리고 audit가 있습니다. 전체
집합은 keon --help를 실행하세요.
출력 형식
기본값은 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"를 클릭하세요. 머신당 한 번입니다. winget install Seiraiyu.Keon으로 설치하면 이 프롬프트를 피할 수 있습니다.
(macOS 바이너리는 서명 및 공증되어 있으며; Windows 빌드의 SmartScreen
평판은 시간이 지나면서 쌓입니다.)