居続ける
エージェント。

識別名ごとに一つのサービス

各常駐エージェントは、systemd・launchd・タスクスケジューラ配下の独立したゲートウェイプロセスです。OS が再起動を担い、ターミナルを閉じてもエージェントは止まりません。登録は kurahi service の一コマンドです。

一つの状態ルート

識別名が所有するすべては KOLO_HOME 配下にあります。kurahi init が唯一の初回コマンドで、識別名、バインド方針、プロバイダープロファイル、診断レポートを一度に設定します。--lang ja で日本語メッセージ。

スコープ付きペアリング

observe・attach・admin・owner のスコープを持つ一回限りの招待を、サーバー側で強制します。端末はサーバーが発行したノンスに署名して、Ed25519 秘密鍵の保有を証明し、短命のアクセストークンとローテーションするリフレッシュトークンを受け取ります。失効済みトークンの再利用はファミリー全体を取り消し、一定期間後に再同意を求めます。

監査チェーンと整合性ゲート

すべての認証、ペアリング、接続、管理操作、ツール実行をハッシュチェーンログに追記し、kurahi audit verify が再計算します。保護されたポリシーファイルは起動時にダイジェスト照合され、enforce モードでは不一致で起動を拒否します。

仕様が明文化された API

ルータから生成した OpenAPI 3.1 を /doc で提供します。HTTP 65 操作と WebSocket 104 メソッドのそれぞれに認証種別と最小スコープを明記。@kodasoken/kurahi-client はこの文書から生成され、乖離があれば CI が失敗します。kurahi api でゲートウェイのあらゆる操作に届きます。

複数クライアントを持つセッション

attach スコープの資格情報なら、稼働中のセッションを一覧し、ターミナル、スクリプト、メッセージングパイプを接続できます。接続中のすべてのクライアントが同じイベントストリームを受け取ります。LINE と WhatsApp のパイプは独立したボットではなく、セッションのクライアントです。

Code Mode と MCP

エージェントが一本のスクリプトを書き、サンドボックスワーカーの中で多数のツールを一往復で呼び出します。実時間、ヒープ、ツール呼び出し数に上限。stdio または HTTP の MCP サーバーは、同じポリシーと監査の下でツールとして現れます。

エージェント制御とジョブ

実行ごとのステップ上限、同一呼び出しや進捗のない呼び出しを止めるループ検出、パスとコマンドに対するパーミッショングロブ。すべての実行はジョブとして一覧・参照・取消でき、完了通知を伴います。取消は監査されます。

ライフサイクルを持つプラグイン

マニフェストとスキーマを持つインプロセスプラグイン。ゲートウェイを再起動せずにホットリロードし、dispose 手順と、失敗時の隔離を備えます。同梱の運用プラグインは六つ：ヘルスウォッチドッグ、ログローテーション、起動時のメモリ読み込み、概日リズム、自己診断、能動トリガ。

バンドル、更新、サポート

Linux・macOS・Windows 向けのビルド済みバンドルにランタイムを固定同梱。Node.js のインストールは不要です。各リリースに SHA-256 チェックサム、CycloneDX SBOM、SLSA 来歴を付し、kurahi update はチェックサム不一致を拒否します。kurahi support は秘匿情報を除いた診断バンドルを書き出します。

シークレットとプロバイダー

暗号化されたシークレットストア（OS キーリングまたは暗号化ファイル）。引数にもログにも秘密は現れません。プロバイダー非依存：国内ホストの既定プロファイル（さくらのAI Engine）、お手持ちの鍵で使う OpenAI 互換エンドポイント、ローカルモデルサーバー。209 件のプロバイダーレジストリ（厳選 17 件、公開カタログから生成 192 件）。kurahi providers test は一回の要求でレイテンシを報告します。

証明された継続性

モデル入れ替え、ゲートウェイ再起動、状態ディレクトリ移動、セッション終了の後も同じ常駐者であることを、適合性スイートが示します。署名付きハッシュチェーンマニフェストに対する十の不変条件 C0〜C9：アイデンティティファイル、メモリの保持と想起、ロールとパーミッション、未完の仕事、監査チェーン、シークレット、署名者、セッションとトランスクリプト、そして常駐者が自分として答えること。kurahi continuity run・verify・badge。スイートは push ごとに CI で走ります。

再生できる証跡バンドル

すべてのジョブが、モデルターン、ツール呼び出し、ファイルスナップショット、パーミッション判断、ループガードの判定をハッシュチェーンのイベントログに記録し、終了時に署名します。kurahi evidence export が書き出すバンドルは第三者がオフラインで検証でき、kurahi evidence replay と /evidence/<job> ビューがイベント単位で再生します。

コードで定義するポリシー

ゲートウェイごとに一つの署名付き policy.yaml。enforce モードでは未署名を拒否します。エージェント別とフリート全体の予算（日あたりのトークンとコスト、時間あたりのツール呼び出し、ジョブあたりの実時間）、ツールクラス別の承認、egress 許可リスト、そして稼働中のジョブをイベントループ一ティック以内に中断するキルスイッチ。すべての判断は決定した規則とともに監査されます。kurahi policy show・validate・sign・verify・diff・apply・kill・release。

チャネルネイティブな常駐者

会話ごとに一つのセッション。/status・/jobs・/cancel・/evidence などのコマンドをどのチャネルからでも。承認はチャネル内のキーワードで回答。チャネル別の配信キューに再試行、重複排除、デッドレター。システム応答は英語・日本語・ポルトガル語。その他の連携には汎用 webhook チャネル。

ファクトリ

KOLO_HOME/factory 配下のボードとカード。inbox から merged までを監査された状態機械が司ります。ランナーが各カードを KIP ヘッドレスエンジンにジョブとして渡し、イベントをカードのタイムラインと証拠ログに流し、プルリクエストを開き、カードのポリシーの下でのみマージします。/factory カンバン、API、コマンドラインの kurahi factory。

ターミナル機能の強化

セッション切替、ファイル編集の統一差分、スラッシュコマンド、八つのテーマと JSON テーマファイル、全操作への直接キーとリーダーキーを使ったキー操作、Markdown / JSON へのエクスポート、外部エディタ、編集後のフォーマッタ、undo / redo 付きのファイルスナップショット、@path 添付。

言語サーバー

write・edit・apply_patch の結果に診断を追記し、エージェントは同じターンで型エラーを見ます。定義、参照、ホバー、診断をツールとして提供。TypeScript・Python・Go・Rust・Java の既定を同梱。サーバーはコマンドが PATH にあるときだけ起動し、何もダウンロードしません。

三つのプラットフォームで検証

リリース 2.0.3 は、Linux・macOS・Windows の CI でユニット、ゲートウェイ、拡張の各テストスイートを通過しました。Linux バンドルは公開インストーラーから導入し、PATH に Node.js がない状態で kurahi --version に応答することを確認しています。