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 me

keon login はループバック OAuth フローを実行します — キーの貼り付けは不要です。ランダムなポートでローカルリスナーを起動し、ブラウザをコンソールの認可ページへ開き、リダイレクトを待ちます。あなたが認可した後、CLI は使い捨てのコードを POST /v1/cli/exchange で、アクティブな組織にスコープされた長命の nsk_ 接頭辞付き API キーと交換します。

キーはモード 0600 で ~/.config/keon/credentials.json に永続化されます。CLI は結果として得られたキーのみを保持し、OAuth コード、state、いかなるプロバイダトークンも保持しません。keon logout はサーバー側でキーを失効させ、ファイルを削除します。 Settings → API keys からいつでも失効させることもできます。完全なフローについては認証を参照してください。

よく使うコマンド

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

SKILL.md とリファレンスドキュメントを ./.claude/skills/keon/ に配置するので、Claude エージェントはセットアップのターンなしに CLI を操作できます。

トラブルシューティング

macOS：「開発元を確認できません」

ブラウザ経由でダウンロードされ、Gatekeeper の属性が設定されたバイナリでのみ発生します。その属性を取り除いてください。

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

Windows：SmartScreen の警告

「詳細情報」→「実行」をクリックします。マシンごとに 1 回だけです。 winget install Seiraiyu.Keon でインストールすればこのプロンプトを回避できます。（macOS バイナリは署名され公証されています。Windows ビルドの SmartScreen レピュテーションは時間とともに構築されます。）

バグの報告

github.com/Seiraiyu/seiraiyu-neon/issues

On this page