使い方

1. インストールと初回起動

お使いのOS向けにKaoruをダウンロードします。ボタンを押すと他のページを経由せずにダウンロードが始まります。その後インストーラーを開き、初回起動ガイドに進んでください。

Kaoruをダウンロード

OSを選んでください。クリックでダウンロードが始まります（バージョン2.3.1）。

git clone https://github.com/Dregxmoon/Kaoru-Agent.git
cd Kaoru-Agent
npm install
npm run rebuild
npx electron .

詳しいインストール手順 ↗RAM・CPU・ディスクの暫定要件（スペイン語） ↗

2. プロバイダー、モデル、費用

Kaoruの設定でプロバイダーとモデルを選び、利用権限のあるキーまたは互換エンドポイントを設定します。プロバイダーのデータポリシー、上限、料金を確認してください。オープンソースのソフトウェアにAPIの利用料は含まれません。ローカルモデルを使っても、TTS、ブラウジング、連携が自動でオフラインになるわけではありません。

3. ワークスペースとルール

チャットのツールバーからプロジェクトのフォルダーを選び、依存関係とルールを準備します。AGENTS.md、CLAUDE.md、.cursorrulesを取り込めます。作業と無関係なファイルは含めないでください。プロジェクトルールは作業の指針となり、実行権限は別に判定されます。

4. ターミナルとサイドチャット

ワークスペースでターミナルを作成し、Chatからシェルを止めずに連携チャットを開けます。出力を選択してKaoruに質問すると、送信前に確認できるカードとして添付されます。エラーの説明は下書きを作ります。チャット内の1行コマンドは実行せずに貼り付けるか、明示的な確認後に実行できます。シェルは利用者の権限で動きます。

5. 最初の依頼の例

「このフォームの入力検証を調べ、関連ファイルと必要なテストを示してください。まだ編集しないでください」と依頼してみてください。その後、結果を確認できる具体的な変更を許可します。計画、操作履歴、差分を確認し、作業を止めたいときは生成をキャンセルしてください。

6. テストと完了の確認

プロジェクトの検証コマンドを設定します。smartモードでは、認識された変更後に品質チェック用スクリプトや、補助的なJavaScript構文チェックを実行できます。関連テストの自動選択はtests/run-all.shに対応し、それ以外は設定が必要です。影響範囲の推定は近似であり、結合テストの代わりにはなりません。

7. 音声、ブラウザー、OS

複数のアプリを使う場合は、確認したい結果を伝えてください。例：「エディターでレポートを開き、リマインダーを作り、表示されたことを確認して」。Kaoruは計画を見直し、最初に許可を求め、結果ごとに進みます。アクセシビリティで確認できない結果は未完了として知らせます。ニューラル音声は同梱されておりインターネット接続が必要です。現在の画面ではマイク入力は利用できません。URLを開く際は既定のブラウザーを、ページの検査には管理対象Chromiumを使います。LinuxはAT-SPI2、WindowsはUI Automationに対応し、macOSは一部対応です。

8. 連携とチームでの利用

権限のあるアカウントだけを接続してください。GitHubでは必要なスコープを選び、不要なアクセスを取り消します。プラグインの配布元や権限を確認してください。顧客データを使う前にテスト用リポジトリで試し、端末外に送れる文脈の範囲を合意してください。

9. 作業の継続と復旧

記憶と永続的な目標には、正常に動作するローカルストレージが必要です。重要な操作の前にバックアップを用意してください。チェックポイントは外部サービスの操作を自動で取り消しません。読み取り専用のサブエージェントは並列に調査できますが、ワークスペースを変更する処理は直列で実行します。

10. 顧客へ引き渡す前に

機能、差分、テスト、報告された制限を確認します。その環境のプロバイダー、権限、データの扱いを記録してください。商用で配布する場合は自作または適切な利用権限のあるアバターを使用します。三月なのかのアセットはMITの対象外です。このサイトは契約上のサポートやSLAを提供するものではありません。