# 🤖 LibrAgent

> **実際のツールを使い、並列に働き、しかも自分の管理下に置けるAIエージェントのためのローカルファーストなデスクトップアプリ。**
> _任意のLLMを接続し、任意のMCPサーバーを追加して、エージェントにファイル読み取り、シェル実行、ウェブ操作、自動化の完遂まで任せられます。_

[English](./README.md) | [한국어](./README.ko.md) | [简体中文](./README.zh.md) | [Français](./README.fr.md) | [Español](./README.es.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Built with Tauri](https://img.shields.io/badge/Built%20with-Tauri-24C8DB?logo=tauri)](https://tauri.app)
[![Rust](https://img.shields.io/badge/Rust-Latest-CE422B?logo=rust)](https://www.rust-lang.org)

LibrAgentはTauri + Rust + Reactで構築された**ローカルファーストのエージェントワークスペース**です。単なるチャットUIではなく、実ファイルへのアクセス、シェル実行、ブラウザ自動化、MCP拡張性、そしてデモ一発で終わらず何時間も走り続けるマルチエージェントワークフローのために作られています。

クラウドモデルでも、Ollamaのようなローカルランタイムでも接続できます。すでに使っているツールからMCPサーバーを取り込み、コード調査、ファイル編集、コマンド実行、ウェブ閲覧、知識蓄積、サブタスク委任をエージェントに任せてください。作業全体を他人のクラウドVMに渡す必要はありません。

**ここから始める:** [最新リリースをダウンロード](https://github.com/fritzprix/libr-agent/releases/latest) · [5分オンボーディングへ移動](#5分オンボーディングパス) · [実際のユースケースを見る](#-実際のユースケース)

---

## なぜLibrAgentなのか？

多くのエージェント製品は、まだこの面倒なトレードオフを押しつけてきます。

- **UIは簡単。でも実行力が弱い**
- **自動化は強い。でも製品として粗い**
- **クラウドは便利。でもプライバシー制御が弱い**
- **フレームワークは柔軟。でも全部自分で組み立てる羽目になる**

LibrAgentが狙っているのは、みんなが本当に欲しい中間地点です。

- **ローカルファーストな制御**：ファイル、ワークスペース、セッション、ブラウザ状態を基本的に手元に残せる
- **閉じたプラグイン路線ではなくMCPによるオープンな拡張性**
- **シェル、ブラウザ、ワークスペース、知識ツールを横断する実行力**
- **パワーユーザー向けの深さを失わないGUI**
- **一人のエージェントから複数のチームへ自然に広げられる構造**

### LibrAgentが対象とするユーザー

- **ソロ開発者**：実際にローカルで読み書き実行・ブラウズしてコンテキストを維持するエージェントが欲しい人
- **パワーユーザーとオペレーター**：ローカルモデル、APIプロバイダー、MCPサーバー、スケジュールワークフローから独自スタックを構築したい人
- **研究者・アナリスト**：ブラウザ自動化、知識取得、反復可能なプレイブック、長時間セッションが必要な人
- **プライバシー重視のチーム**：ローカル実行、明示的なガバナンス、単一エージェントから調整された組織へのパスが欲しいチーム

---

## 🎬 プラットフォーム動作

![LibrAgent Demo](assets/demo_1280_4x_optimized.gif)

_単一エージェントから協調クラスターまで——再帰的委任、MCPツール、持続的ワークスペースが一つの統合基盤に。_

---

## 最初の10分でできること

### 1. 実ツールでリポジトリをレビューする

- Workspaceツールでローカルリポジトリを接続
- GitHub MCPプリセットを追加
- _「PR #42のセキュリティ問題を見つけて、レポートとして保存して」_ と依頼

### 2. 完全ローカルなエージェントスタックを作る

- `ollama pull qwen3:14b` を実行
- Workspace + Shell を接続
- コードをクラウドVMへ送らずに、エージェントへ読み取り、修正、テスト、反復を任せる

### 3. 調査を繰り返し使えるワークフローに変える

- Browser + Knowledge を追加
- _「この競合ブログ5件を追跡して、毎朝要約して」_ と依頼
- 単発タスクを定期パイプラインへ変換

### 4. 一人のアシスタントから本物のチームへ進む

- `teamwork` で共有ワークスペースを scaffold
- `delegate` で作業を分割
- `org` または `schedule` で継続的な協業を正式化

---

## デモの後でも崩れない理由

### 1. 🔐 ローカルファーストセキュリティ——データはあなたのマシンに

LibrAgentはセキュリティをファーストクラスのアーキテクチャ上の関心事として扱います：

- **セッション分離**：すべてのエージェントセッションが専用の`MCPServiceProxy`インスタンスを持つ——クロスセッションのデータ漏洩ゼロ
- **内蔵SecurityValidator**：パストラバーサル攻撃とコマンドインジェクションをシステムレベルでブロック
- **クラウド基盤不要**：中核となる実行はローカルで完結し、外部接続も主に選択したクラウドLLMプロバイダーやリモートMCP/HTTPサービスに限られ、加えて本番ビルドでは新しいリリースを確認する更新チェックが走ることがあります
- **完全オフラインサポート**：[Ollama](https://ollama.ai)とペアでエアギャップされたエージェントスタック

#### ローカルに留まるものと離れるもの

- **常にローカル**：ワークスペース、ローカルファイル、バンドルスキル、セッション状態、MCPサーバー設定、ブラウザ状態、ローカルツール実行
- **必要な時にのみ離れる**：明示的に設定したクラウドLLMプロバイダーやリモートMCP/HTTPサービスへのリクエスト、そして本番ビルドでの新しいリリース確認用アップデートチェック
- **完全オフラインモード**：OllamaやローカルMCPサーバーでエアギャップされたワークフロー

### 2. 🧩 MCPネイティブエコシステム——設計による無限の拡張性

MCP（Model Context Protocol）は、LibrAgentの拡張性モデルを支えるオープンスタンダードです。LibrAgentはこれを機能としてではなくアーキテクチャの骨幹として扱います：

- **完全なトランスポートサポート**：stdio、HTTP、SSE、OAuth 2.1——完全な仕様
- **12以上の内蔵サーバー**：Planning、Knowledge(RAG)、Browser Automation、Workspace、Shell Execution、Content Storeなど
- **プリセットカタログ**：GitHub、Brave Search、Filesystemなど人気サーバーをワンクリックでインストール
- **セッション分離インスタンス**：各エージェントセッションが独立したMCPサーバー状態を持つ——並列エージェント間で干渉なし
- **どこからでもインポート**：Cursor、VS Code、Claude Code、WindsurfからMCP設定を自動移行

### 3. 🦾 プロダクショングレードの実行基盤

ほとんどのAIツールはデモでは印象的ですが、プロダクションでは脆弱です。LibrAgentは長時間の実際の作業のために徹底的にエンジニアリングされています：

| 基盤          | 機能                                                                                         |
| ------------- | -------------------------------------------------------------------------------------------- |
| **Workspace** | 行単位の精密編集、マルチファイル操作、統合検索、`@file`/`@skill`/`@playbook`コンテキスト注入 |
| **Shell**     | 分離実行 AND 持続シェル——非同期プロセス監視(`poll`、`read output`、`list`)                   |
| **Browser**   | Playwrightライクな操作モデルを備えたヘッドレスブラウザ自動化とキャッシュ一貫性保証           |
| **Knowledge** | エンティティ/関係抽出(v2)、BM25全文検索付きグラフベース知識管理                              |

**信頼性エンジニアリング込み**：コンテキスト圧縮、ループ防止、サーキットブレーカー、陳腐化レスポンスガードで数時間に及ぶセッションでもエージェントを生産的に保ちます。

### 4. 🤝 クラスター→チーム→組織：あらゆる規模のマルチエージェント

LibrAgentはソロ実行から明示的な組織調整まで一貫したマルチエージェントのストーリーを持ちます：

- **`delegate`**：親エージェントが明示的系譜追跡で子セッションを生成、ブリーフィング、監視
- **`teamwork`**：ワンコマンドで完全なタスクフォースワークスペース(agents.md、MISSION.md、KANBAN.md)をスキャフォールド
- **`org`**：持続的組織アイデンティティ、ルートセッション再開、org-visibleメンバー階層でチームを正式化
- **`schedule`**：CRONベースの自動化——エージェントが無人で、スケジュール通りに、ワークスペース憲法に従って実行
- **Concurrency Gate**：並列セッションとシェルプロセスのハードリミットでデッドロックとコスト暴走を防止

### 5. ⚡ バンドルスキル——空のインストールから動作するクラスターへの最速ルート

LibrAgentは成長し続ける**バンドルスキル**ライブラリを同梱します。ランダムなプロンプトではなく——任意のエージェントが名前で呼び出せる再利用可能な操作手順です。

最重要のday-oneスキル：

| スキル               | 機能                                                                                      |
| -------------------- | ----------------------------------------------------------------------------------------- |
| `system-setup`       | すべてのプラットフォームで不足しているランタイム(Python、Node.js、uv)を検出・インストール |
| `mcp-installer`      | npmパッケージ、GitHub URL、JSON設定ブロックからMCPサーバーを登録                          |
| `mcp-importer`       | Cursor、VS Code、Windsurf等から既存MCP設定をインポート                                    |
| `delegate`           | 明示的なコンテキスト転送と系譜追跡付きで親→子セッションの引き継ぎを案内                   |
| `teamwork`           | 調整されたマルチエージェント作業のための共有ワークスペース憲法をスキャフォールド          |
| `org`                | 持続的な組織アイデンティティとorg-visibleメンバー階層を正式化                             |
| `schedule`           | 無人自動化のための定期スケジュールタスクグループを作成・管理                              |
| `soul-awakening`     | エージェントを`SOUL.md`ペルソナに固定——トーン、スタンス、アイデンティティ                 |

これはオペレーターレイヤーだけです。LibrAgentはドメインスキルも提供します：

- **知識と研究**：`deep-research-report`、`knowledge-distiller`
- **ドキュメントワークフロー**：`document-to-markdown`、`docx`、`pptx`
- **スキルとワークフロー作成**：`skill-creator`、`skill-deployer`、`playbook-creator`、`mcp-builder`
- **特殊操作**：`computer-diagnosis`および他の専門ヘルパー

_重要：`bootstrap`はこれらのスキルと並行して使用される内蔵機能です。バンドルスキルは再利用可能な手順であり、内蔵機能とMCPツールはその下の実行基盤です。_

---

## 🌍 実世界のシナリオ

### ソロ開発者——自動コードレビュー

1. WorkspaceツールでローカルリポジトリをConnect
2. GitHub MCPプリセットをインストール（ワンクリック）
3. 依頼：_「PR #42のセキュリティ問題を見つけてMarkdownレポートを作成」_
4. エージェントがコードを読み、分析を実行し、発見事項をKnowledgeサーバーに保存

### マーケター——競合情報をオートパイロットに

1. Browserツールで5つの競合ブログを設定
2. エージェントに伝える：_「毎朝7時に競合ブリーフを予約して」_——エージェントが`schedule`スキルで定期タスクグループを設定
3. エージェントがブラウズ、要約し、Knowledge storeに追記
4. いつでも聞く：_「先週の競合の動向を要約して」_

### エンジニアリングチーム——オフラインエージェントスタック

1. `ollama pull qwen3:14b`——APIキー不要、クラウド不要
2. Workspace + ShellツールをコードベースにConnect
3. 機密IPがマシンから外に出ない
4. エージェントが読み、修正し、テストし、コミット——完全ローカル

### パワーユーザー——マルチエージェント研究パイプライン

1. `teamwork`でリサーチタスクフォースをスキャフォールド（役割、MISSION.md、KANBAN.md）
2. オーケストレーターが`delegate`スキルで並列委任
3. 結果がContent Storeの単一構造化レポートにマージ
4. `schedule`でワークフロー全体を週次予約

---

## 📖 ドキュメントとガイド

- **[ナビゲーションガイド](docs/guides/navigation-guide.md)**：Command & Controlハブ——`/assistants`(ロール定義)と`/playbooks`(ワークフロー設計図)。
- **[アーキテクチャガイド](docs/architecture/agent-workflow-architecture.md)**：セッション分離、オーケストレーションエンジン、RustドリブンのThink-Act-Observeループ。
- **[内蔵ツールガイド](docs/guides/builtin_tool_bp.md)**：ツール設計標準とMCPレスポンスパターン。

---

## 📦 はじめに

**[リリースページ](https://github.com/fritzprix/libr-agent/releases/latest)**からプラットフォーム別の最新インストーラーをダウンロード。

<!-- RELEASE_DOWNLOADS_START -->
- **Windows:** [`LibrAgent_0.8.10_x64-setup.exe`](https://github.com/fritzprix/libr-agent/releases/download/v0.8.10/LibrAgent_0.8.10_x64-setup.exe) · [`LibrAgent_0.8.10_x64_en-US.msi`](https://github.com/fritzprix/libr-agent/releases/download/v0.8.10/LibrAgent_0.8.10_x64_en-US.msi)
- **macOS (Apple Silicon):** [`LibrAgent_0.8.10_aarch64.dmg`](https://github.com/fritzprix/libr-agent/releases/download/v0.8.10/LibrAgent_0.8.10_aarch64.dmg)
- **Linux:** [`LibrAgent_0.8.10_amd64.AppImage`](https://github.com/fritzprix/libr-agent/releases/download/v0.8.10/LibrAgent_0.8.10_amd64.AppImage) · [`LibrAgent_0.8.10_amd64.deb`](https://github.com/fritzprix/libr-agent/releases/download/v0.8.10/LibrAgent_0.8.10_amd64.deb) · [`LibrAgent-0.8.10-1.x86_64.rpm`](https://github.com/fritzprix/libr-agent/releases/download/v0.8.10/LibrAgent-0.8.10-1.x86_64.rpm)
- **すべてのリリース資産:** [リリースページ](https://github.com/fritzprix/libr-agent/releases/tag/v0.8.10)
<!-- RELEASE_DOWNLOADS_END -->

**開発者セットアップ：**

```bash
git clone https://github.com/fritzprix/libr-agent
cd libr-agent
pnpm install
pnpm tauri dev
```

### 5分オンボーディングパス

**ステップ1——モデルを接続** (Settings → LLM Providers)

- クラウド：OpenAI / Anthropic / Gemini / Groq APIキーを貼り付け
- ローカル：`ollama pull qwen3:14b`後にSettingsでOllamaを選択
- CursorやVS Codeを使用中？任意のエージェントに：_「CursorからMCPサーバーをインポートして」_ → `mcp-importer`が対応

**ステップ2——MCPツールを追加** (Extensionsサイドバー)

- プリセットカタログを閲覧してInstallをクリック、または
- エージェントに：_「Install @modelcontextprotocol/server-everything」_ → `mcp-installer`が自動登録

**ステップ3——最初のエージェントを作成**

- _「競合情報のためのresearcherエージェントを作成して」_ → Assistants設定または`agent__create`で作成
- _「現在のツールでresearchチームを構築して」_ → `teamwork`が役割と共有ワークスペースをスキャフォールド
- _「並列リサーチサブタスクを実行して」_ → `delegate`が子セッションを生成・監視

**ステップ4——`delegate`で並列作業**

- 任意のエージェントに子セッションへのサブタスク委任を依頼
- `delegate`スキルがコンテキスト引き継ぎ、系譜追跡、結果マージを管理

**ステップ5——持続的チームを構築**

- `teamwork` → `agents.md`、`MISSION.md`、`KANBAN.md`で共有ワークスペースをスキャフォールド
- `org` → 持続的アイデンティティとorg-rootセッション管理でチームを正式化
- `schedule` → 無人CRONベースの自動化をエージェントが作成・管理

### コピーペーストできる最初のプロンプト

- _「CursorからMCPサーバーをインポートして何が追加されたか見せて。」_
- _「現在のツールで競合情報のためのresearcherエージェントを作成して。」_
- _「GitHub MCPプリセットをインストールしてcodingエージェントに接続して。」_
- _「リポジトリ分析を子セッションに委任して要約を返して。」_
- _「このリポジトリのteamworkワークスペースを準備して、org-readyなspecialistチームを作成して。」_
- _「毎朝7時に予約された日次競合ブリーフを設定して、shared teamworkワークスペースに保持して。」_

---

## LibrAgentが特にハマるケース

| こういうものが欲しいなら…                                    | LibrAgentが強い理由                                                             |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| **ローカルAIワークステーション**                             | ファイル、セッション、ワークスペース、ブラウザ状態が基本的に自分のマシンに残る  |
| **MCPネイティブなデスクトップ製品**                          | 薄いラッパーではなく、MCPサーバーの導入・インポート・管理まで製品内で完結できる |
| **本当に仕事を進めるエージェント**                           | Workspace、Shell、Browser、Knowledge が長時間実行を前提に設計されている         |
| **先にフレームワークを組まなくていいマルチエージェント運用** | `delegate`、`teamwork`、`org`、`schedule` がすでに製品に入っている              |
| **GUIの使いやすさとパワーユーザーの深さの両立**              | デスクトップUIを使いながら拡張性と制御力を失わない                              |

---

## 設計哲学

- **ローカルファースト**：データ、キー、エージェントの「魂」はあなたの完全な管理下に。クラウド基盤不要。
- **ハーネス優先**：実行環境——ツール、セッション状態、委任、ガバナンス——が個々のモデルより重要。LibrAgentはどのモデルでも最大限のパフォーマンスを発揮できるようエンジニアリング。
- **安定性優先**：CHANGELOGはランタイムの正確性への強迫的なフォーカスを反映——セッション分離、圧縮、ループ防止、陳腐化レスポンスガード。
- **インフラとしてのMCP**：プラグインシステムではなく。ツールエコシステム全体がMCPを主要な相互運用性レイヤーとして構成。
- **オープンスタンダード**：MITライセンス。MCP、オープンソースの相互運用性、ユーザーデータ主権に完全にコミット。

---

## 貢献とライセンス

LibrAgentはMITライセンスで公開されたオープンソースです。バンドルスキル、MCP統合、バグ修正、アーキテクチャ改善など、あらゆる貢献を歓迎します。

- 📖 [貢献ガイド](CONTRIBUTING.md)
- 🐛 [イシュートラッカー](https://github.com/fritzprix/libr-agent/issues)
- 💬 [ディスカッション](https://github.com/fritzprix/libr-agent/discussions)

**ライセンス**: MIT
