rait-09_obsidian-agent-client/README.ja.md

Agent Client Plugin for Obsidian

AIエージェント（Claude Code、Codex、Gemini CLI）をObsidianに直接統合。Vault内からAIアシスタントとチャットできます。

このプラグインは、Zed の Agent Client Protocol (ACP) で構築されています。

https://github.com/user-attachments/assets/1c538349-b3fb-44dd-a163-7331cbca7824

機能

• ノートメンション: @ノート名でノートを参照
• 画像添付: チャットに画像をペーストまたはドラッグ&ドロップ
• スラッシュコマンド: エージェントが提供する/コマンドを使用
• マルチエージェント: Claude Code、Codex、Gemini CLI、カスタムエージェントを切り替え
• マルチセッション: 複数のエージェントを別々のビューで同時実行
• フローティングチャット: 素早くアクセスできる折りたたみ可能なチャットウィンドウ
• モード・モデル切り替え: チャット画面からAIモデルやエージェントモードを変更
• セッション履歴: 過去の会話を再開またはフォーク
• チャットエクスポート: 会話をMarkdownノートとして保存
• ターミナル統合: エージェントがコマンドを実行し結果を返す
• MCPサポート: エージェントに設定済みのMCPサーバーがそのまま利用可能 — プラグイン側の追加設定は不要

インストール

コミュニティプラグインから（推奨）

1. 設定 → コミュニティプラグイン → 閲覧 を開く
2. 「Agent Client」 を検索
3. インストール → 有効化 をクリック

BRAT経由（プレリリース版）

コミュニティプラグインに公開される前のプレリリース版を試すには:

1. BRAT プラグインをインストール
2. 設定 → BRAT → Add Beta Plugin に移動
3. 貼り付け: https://github.com/RAIT-09/obsidian-agent-client
4. プラグインリストから Agent Client を有効化

手動インストール

1. リリースから main.js、manifest.json、styles.css をダウンロード
2. VaultFolder/.obsidian/plugins/agent-client/ に配置
3. 設定 → コミュニティプラグイン でプラグインを有効化

クイックスタート

ターミナル（macOS/LinuxではTerminal、WindowsではPowerShell）を開き、以下のコマンドを実行します。

1. エージェントとACPアダプタをインストール（例: Claude Code）:

   curl -fsSL https://claude.ai/install.sh | bash   # Claude Codeをインストール
   npm install -g @agentclientprotocol/claude-agent-acp   # ACPアダプタをインストール
   

2. ログイン（APIキーを使う場合はスキップ）:

   claude
   

   プロンプトに従ってAnthropicアカウントで認証します。

3. パスを確認:

   which node   # macOS/Linux
   which claude-agent-acp
   
   where.exe node   # Windows
   where.exe claude-agent-acp
   

4. 設定 → Agent Client で設定:

   • Node.js path: 例: /usr/local/bin/node
   • Built-in agents → Claude Code → Path: 例: /usr/local/bin/claude-agent-acp（claudeではない）
   • API key: キーを追加、またはCLIでログイン済みの場合は空欄

5. チャット開始: リボンのロボットアイコンをクリック

セットアップガイド

• Claude Code
• Codex
• Gemini CLI
• カスタムエージェント（OpenCode、Qwen Code、Kiro、Mistral Vibeなど）

ドキュメント全文

開発

npm install
npm run dev

プロダクションビルド:

npm run build

ライセンス

Apache License 2.0 - 詳細は LICENSE を参照。

Star History