開発者クイックスタート

このガイドでは、ローカルの kanade 開発環境をセットアップして起動する手順を説明します。

1. Prerequisites

開始する前に、Windows マシンに以下がインストールされていることを確認してください。

  • Rust toolchain (stable channel)
  • cargo-make (run cargo install --force cargo-make)
  • bun (for SPA dependency management and build execution)
  • gsudo (for local service deployment tests)
  • nats-server (runnable from PATH)

2. One-Time Setup

ワークスペースのルートで以下のコマンドを実行し、git の pre-push フックを登録し、apm.yml で定義されたエージェントスキルをインストールします。

cargo make setup

3. Launching the Dev Sandbox

単一のコマンドを使用するだけで、ローカルホスト上に完全に分離されたマルチコンポーネント開発スタックを起動できます。

cargo make dev

このタスクは、ループバックサンドボックス内で以下のサービスを並行して実行します。

  1. nats-dev: Unauthenticated NATS broker listening on port 4223.
  2. backend-dev: Dev API server listening on port 8081 with auth disabled.
  3. agent-dev: Local dev agent talking to the dev NATS broker on 4223.
  4. web-dev: Vite dev server for the React SPA listening on http://localhost:5173.

Ctrl+C を押すことで、すべてのコンポーネントをクリーンに終了できます。

4. Multi-Agent Fleet Simulation

複数のマシンを管理しているときにのみ発生する動作（並行実行結果のプロジェクションや ID 衝突など）をデバッグするために、マルチエージェントサンドボックスを起動できます。

cargo make dev-fleet

これにより、NATS ブローカー、バックエンド、SPA に加えて、独立した ID（dev-pc-1、dev-pc-2、dev-pc-3）と隔離された状態データベースを持つ 3 つの個別開発用エージェントが起動します。

5. Local Deploy Testing

Windows サービスとしてコンポーネントをインストールする全ライフサイクル（本番環境の模倣）をテストしたい場合は、ローカルデプロイスクリプトを使用します。

# Installs CLI, agent, backend, and NATS services locally via gsudo elevation
cargo make local-deploy

デプロイ後、実際の Windows サービスを確認して対話できます。完了したら、以下のタスクを使用してサービスを停止し、きれいに削除します。

cargo make local-undeploy