agentrq/agentrq

AgentRQ: Human-in-loop realtime conversational task manager for AI Agents. Self-hosted! Control your own agents from wherever you want Mobile, Web, Desktop. Designed to work well with your own Claude subscriptions and any harness with ACP support.

AgentRQ – 人間とAIエージェントのためのコラボレーションプラットフォーム

概要 – AgentRQは、人間オペレーターと1つ以上のAIエージェント（例：Claude、Antigravity、Codex）が共通のタスクワークスペースを共有できるようにする、オープンソースでセルフホスト可能なWeb/デスクトップアプリケーションです。このプラットフォームは、エージェントがリモートツールセットのように呼び出せるModel Context Protocol (MCP)サーバーを公開しています。タスクの作成、ステータスの更新、メッセージへの返信、イベントの発火、「メモリ」ノートの読み書きなどが可能です。エージェントは人間UIと同じ状態を確認できるため、ユーザーがループ内に留まりながら自律的に作業できます。

主要機能（READMEに記載されているもの）

機能	提供されるもの
ビジュアルタスクボード	エージェントが作成したすべてのタスクのリアルタイムKanban/リストビュー。ステータス、要件、履歴付き。
タスクスケジューリング	開始日または繰り返し頻度（15分-時間-日-週-カスタム）を割り当てます。バックグラウンドポーラーが期限が来たら正確にタスクを生成します – サーバーサイドの「常時稼働」エージェントは不要です。
イベントとワークフロー	新しいタスクを他のワークスペースでトリガーできる名前付きシグナル（`qa_passed`、`deploy_finished`、…）。ドラッグ＆ドロップのグラフエディターで、YAMLやDSLなしでイベントからワークスペースへのパイプラインを構築できます。
ツール呼び出し履歴	タスク実行中のすべてのツール呼び出しとチャットメッセージのタイムラインビュー。検索可能でドリルダウン可能。
自動タイトル生成	小さなオンデバイス言語モデル（ブラウザにキャッシュ、API呼び出しなし）を使用したワンクリックのタイトル作成。
音声認識	タスク説明や返信用のブラウザ内Whisper転写 – ローカルで処理され、アップロードされることはありません。
メッセージ送信遅延	メッセージがエージェントに届く前の任意のカウントダウン（3-60秒）。キャンセルまたは即時送信が可能です。
キーボード駆動UI	高速でマウスフリーの作業のためのグローバルショートカット（`⌘K`/`Ctrl+K` タスクファインダー、`N` 新規タスク、`M/T` チャット/軌跡ビュー、`?` ヘルプ）。

アーキテクチャ（高レベル）

バックエンド – Go (Fiber) REST API + SSEベースのMCPサーバー（mcp-go）。データはGORM経由でSQLiteに保存、認証はGoogle OAuth2 + JWT、リアルタイム更新のための内部pub/sub。
フロントエンド – Vue 3 + Vite、Piniaによる状態管理、Tailwind CSSとガラスモーフィズムUIによるスタイリング。
デスクトップクライアント – 同じVue UIを実行し、ネイティブ通知、トレイメニュー、グローバルショートカット、ディープリンク処理（agentrq://…）、自動更新を追加するElectronラッパー。
拡張機能 – GitHub（agentrq-extension トピック）で検出されるデスクトップ専用のNodeモジュール。拡張機能はページ、アクション、ショートカット、スケジュールジョブを追加できます。ユーザーの権限で実行され、コアアプリによって仲介されます（サーバーサイドのコード実行なし）。

AIエージェントがAgentRQと通信する方法

MCP URLとトークン – 各ワークスペースは一意のMCPエンドポイントを公開します（https://<workspace>.mcp.agentrq.com/?token=…）。
.mcp.json – プロジェクトディレクトリに配置；エージェントにどのMCPサーバーを使用するかを伝えます。
Claude統合 – .claude/settings.local.jsonファイルでMCPツールのセット（createTask、reply、loadMemoryなど）を事前承認でき、Claude Codeがユーザーに毎回プロンプトを出さずに動作できます。
ACPゲートウェイ – Agent Client Protocolを話すエージェント（Antigravity、Codex）向けに、@agentrq/acp-gatewayがACP ↔ MCPをブリッジし、認証、タスクルーティング、リアルタイム通知を処理します。

始め方（READMEからのクイックスタート手順）

前提条件 – Go 1.21+、Node 18+、Google OAuth2クライアントID/シークレット。

クローンとインストール

git clone https://github.com/agentrq/agentrq.git
cd agentrq
make install          # Goモジュール、npmパッケージなどを取得

ローカル実行

make dev               # バックエンド（Fiber）とフロントエンド（Vite）を同時に開始
# デスクトップUI用の別ターミナルで
make desktop-dev

UIは http://localhost:5173 でアクセス可能です。

デスクトップビルド – 事前構築されたインストーラーはReleasesページで利用可能、またはワンライナーでインストール：
```
curl -fsSL https://agentrq.com/install.sh | sh -s -- --quit
```
セルフホスティング – Dockerイメージと SETUP.md が本番環境対応のcomposeファイルを提供します。

典型的なユースケース

AI支援プロジェクト管理 – Claudeにチケットの生成、スケジューリング、更新を任せ、人間がレビューし、場合によっては明確化を提供します。
継続的統合パイプライン – デプロイ後の検証タスクをAIレビュアー用に自動的に生成するイベント（deploy_finished）を発火します。
ナレッジベース構築 – エージェントは実行間で永続化される memory.md（ワークスペースノート）に書き込み、累積的な学習を可能にします。
ハイブリッドコーディング支援 – CodexまたはAntigravityを同じワークスペースに接続し、タスク割り当てを受け取り、コードスニペットで返信します。すべて共有ダッシュボードで確認できます。

詳細を知る場所

完全な機能リスト: https://agentrq.com/features
デスクトップガイド: docs/DESKTOP.md
拡張機能開発: docs/EXTENSIONS.md
MCPプロトコル仕様: リポジトリからリンク（WebMCP統合）
ACPゲートウェイドキュメント: docs/WEBMCP.md、docs/SLASH_COMMANDS.md

結論 – AgentRQは、モダンなLLMエージェントを人間フレンドリーなタスクボードとブリッジし、自律的かつ監督されたAI作業のための明確に定義されたツールプロトコル（MCP）を公開する、具体的で本番環境グレードのプラットフォームです。完全にオープンソースで、セルフホスト可能であり、Webクライアントとネイティブデスクトップクライアントの両方を含みます。