---

目次

• 概要 — The Pairとは何か、なぜ2つのエージェントがAIの幻覚を減らすのか
• 機能
• スクリーンショット
• インストール — macOS、Windows、Linux
• クイックスタート — プロバイダーCLIをインストールして最初のPairを作成
• 設定
• アーキテクチャ
• 開発
• FAQ

概要

The Pairは、2つのAIコーディングエージェント — 計画とレビューを担う読み取り専用の Mentor と、コードを書きコマンドを実行する Executor — を実行する無料・オープンソースのデスクトップアプリです。両エージェントが互いの作業をクロスチェックし、AIの幻覚がコードベースに入り込む前に検出します。 ローカルで動作し、macOS・Windows・Linuxに対応。モデル非依存で、10種類のプロバイダーCLI — opencode、Claude Code、Codex、Antigravity（Gemini）、Kimi Code、Pi、Kiro、Aider、Grok Build、Muse Code — を自由に組み合わせられます（Ollama経由のローカルモデルも利用可能）。

AIコードの幻覚が心配ですか？ The Pairは、互いにクロスチェックする2つのAIエージェントを実行することでこの問題を解決します：

• Mentorエージェント — 計画、レビュー、検証（読み取り専用）
• Executorエージェント — コードの記述とコマンドの実行

エージェントが作業している間にコーヒーを飲みに行きましょう。戻ってきたら、クロス検証されたコードが準備できています。

主な利点

• デュアルモデルクロス検証 — 2つのモデルが互いの作業をチェックし、コードの幻覚を大幅に削減
• 自動化されたコラボレーション — エージェントが頻繁な人間の介入なしに連携
• リアルタイムモニタリング — エージェントごとのCPU/メモリ使用量とアクティビティをライブ追跡
• Git統合 — セッション中のすべてのファイル変更を自動追跡
• 人間の監督 — いつでも介入して一時停止、調整、タスクの再割り当てが可能
• セッション復元 — 中断されたセッションを完全な会話履歴付きで再開
• オンボーディングウィザード — モデル設定とディレクトリ選択の初回ガイド
• ダーク/ライトテーマ — 自動システムテーマ検出と手動切り替え
• コマンドパレット — ⌘Kですべての操作をあいまい検索しペアへ直接ジャンプ
• ネイティブメニューバー — アプリ / ファイル / 編集 / 表示 / ウインドウ / ヘルプのフルメニューとショートカット
• ペアハブ — ステータス・クイックアクション・復元バナー付きワークスペース別ペアカード
• インスペクターパネル — モデル・実行状態・リソース・ファイル・履歴・タイムラインの折りたたみセクション

ユースケース

• 自律コーディングセッション — AIエージェントが機能を反復している間、あなたはレビューに集中
• コードリファクタリング — 改善の自動分析と実装
• バグ修正 — エージェントが協力して問題を診断・解決
• 学習ツール — AIエージェントが問題を分解・解決する様子を観察
• 中断した作業の復元 — アプリの再起動またはクラッシュ後にセッション状態を復元

---

機能

• デュアルエージェントアーキテクチャ — 計画（Mentor）と実行（Executor）の分離
• フルオートメーションモード — エージェントがワークスペーススコープの権限内で自律的に作業
• リアルタイムアクティビティ追跡 — エージェントのステータスをライブ表示（考え中、実行中、待機中）
• リソースモニタリング — エージェントごとのCPUとメモリ使用量を毎秒更新
• Git変更追跡 — 変更、追加、削除されたファイルを自動検出
• 会話履歴 — すべてのエージェントインタラクションの完全なトランスクリプト
• ローカルオーケストレーション — アプリとエージェントの調整はすべてローカルで実行。モデル呼び出しは選択したプロバイダーまたはローカルモデルに依存
• マルチプロバイダー — 10種類のプロバイダーCLIに対応：opencode、Claude Code、Codex、Antigravity（Gemini）、Kimi Code、Pi、Kiro、Aider、Grok Build、Muse Code
• 推論コントロール — エージェントロールごとに思考の努力度を調整（低/中/高）
• トークントラッキング — ターンごとのリアルタイムトークン使用量をインライン表示
• スキルシステム — エージェントの行動をガイドするプロジェクト固有のスキルファイルを添付
• 自動更新 — アプリ内で更新をチェック、ワンクリックでインストール

---

スクリーンショット

ペアハブ

ペア詳細 — レビュー

コマンドパレット

ライブ実行

---

インストール

GitHub Releasesから最新リリースをダウンロード：

プラットフォーム	ファイル
macOS	the-pair-{version}.zip
Windows	the-pair-{version}-setup.exe
Linux	the-pair-{version}.AppImage.tar.gz (extract, then run the AppImage)

ソースからビルド

git clone https://github.com/timwuhaotian/the-pair.git
cd the-pair
npm install
npm run build:mac  # または build:win / build:linux

macOSでは、build:macはローカルDMGを生成し、build:mac:releaseはGitHub Releasesで使用されるZIP形式のリリースバンドルを生成します。ビルドスクリプトはTauriを呼び出す前に必要なRustターゲットがインストールされるようにします。手動で設定する場合は以下を実行してください：

rustup target add aarch64-apple-darwin x86_64-apple-darwin

---

クイックスタート

[!NOTE] The PairにはAIプロバイダーCLIが少なくとも1つ必要です：opencode、Claude Code、Codex、Antigravity、Kimi Code、Pi、Kiro、Aider、Grok Build、または Muse Code。

1. AIプロバイダーをインストール

サポートされているCLIを1つ以上インストール：

• opencode — curl -fsSL https://opencode.ai/install | bash または npm install -g opencode-ai
• Claude Code — Claude Codeセットアップを参照、または npm install -g @anthropic-ai/claude-code
• Codex — npm install -g @openai/codex
• Antigravity — agy install（Antigravityを参照）
• Kimi Code — curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash（Kimi Codeを参照）
• Pi — インストールとサインインは pi.dev を参照
• Kiro — kiro.dev/downloads からダウンロードし、kiro-cli login
• Aider — python -m pip install -U aider-chat（aider.chatを参照）
• Grok Build — xai-org/grok-build を参照し、grok login
• Muse Code — Muse Codeドキュメントを参照し、muse login

2. AIモデルを設定（オプション）

opencodeベースのモデルの場合、~/.config/opencode/opencode.jsonでAIプロバイダーを設定：

{
  "provider": {
    "openai": { "options": { "apiKey": "your-api-key" } },
    "anthropic": { "options": { "apiKey": "your-api-key" } }
  }
}

[!TIP] Codex、Claude Code、Antigravity（agy）、Kimi Code（kimi）、Pi、Kiro、Aider、Grok Build、Muse Codeはインストール済みCLIからログイン状態を自動検出します。Ollamaでローカルモデルを使用してオフライン開発も可能です。

3. The Pairを起動

アプリケーションフォルダまたはスタートメニューから開きます。

4. 最初のPairを作成

1. New Pair ボタンをクリック
2. 設定：名前、ディレクトリ、タスク説明、AIモデル
3. エージェントの作業を観察 — Mentorが計画、Executorが実装、Mentorがレビュー
4. リアルタイムアクティビティ追跡とファイル変更で進行状況をモニタリング

---

設定

プロバイダー設定

opencodeベースのモデルは既存のopencode設定を使用：

• macOS/Linux: ~/.config/opencode/opencode.json
• Windows: %APPDATA%/opencode/opencode.json

Claude Code、Codex、Antigravity、Kimi Code、Pi、Kiro、Aider、Grok Build、Muse CodeはローカルCLIインストールとアカウント状態から自動検出されます。

Pairランタイム

各Pairは、選択したディレクトリで直接作業するか、独自のgitワークツリー（the-pair/… ブランチ）で作業します。セッション状態（スナップショット、実行レポート、クロスラン知能ストア）はアプリのデータディレクトリに保存され、リポジトリ内には書き込まれません。

[!NOTE] The Pairはグローバルなopencode権限を変更しません。すべての権限はセッション固有です。

---

アーキテクチャ

技術スタック

層	テクノロジー
フレームワーク	Tauri 2.x
バックエンド	Rust
フロントエンド	React 19 + TypeScript
スタイリング	Tailwind CSS v4
状態管理	Zustand
アニメーション	Framer Motion
アイコン	Lucide React

システムアーキテクチャ

┌─────────────────────────────────────────────────────────┐
│                    The Pair App                         │
├─────────────────────────────────────────────────────────┤
│  フロントエンド (React UI)                              │
│  ┌──────────────┬──────────────┬──────────────────┐    │
│  │  Pairs Hub   │ PairConsole  │   Inspector      │    │
│  │  + Activity  │ (Unified)    │  (Collapsible)   │    │
│  │  + Insights  │              │                  │    │
│  └──────────────┴──────────────┴──────────────────┘    │
│                          ↕ Tauri IPC                    │
├─────────────────────────────────────────────────────────┤
│  バックエンド (Rust)                                    │
│  ┌──────────────┬──────────────┬──────────────────┐    │
│  │ PairManager  │MessageBroker │ ProcessSpawner   │    │
│  │ (ライフサイクル)│(ステートマシン)│(マルチプロバイダー)│    │
│  └──────────────┴──────────────┴──────────────────┘    │
│  ┌──────────────┬──────────────┬──────────────────┐    │
│  │ContextBridge │ QualityGate  │   SmartPause     │    │
│  │ (Handoffs)   │ (Verdict)    │ (Coordination)   │    │
│  └──────────────┴──────────────┴──────────────────┘    │
│  ┌──────────────┬──────────────┬──────────────────┐    │
│  │ Git Tracker  │ Worktrees    │ セッションスナップショット│
│  └──────────────┴──────────────┴──────────────────┘    │
│  ┌──────────────┬──────────────┬──────────────────┐    │
│  │リソースモニ. │ Acceptance   │ レポートジェネレーター│
│  └──────────────┴──────────────┴──────────────────┘    │
└─────────────────────────────────────────────────────────┘
                            ↕
              ┌─────────────┴─────────────┐
              ↙                           ↘
     ┌─────────────────┐          ┌─────────────────┐
     │  AIプロバイダーCLI│          │   Gitリポジトリ  │
     │ Claude, Codex,   │          │  (ワークスペース)│
     │ Gemini, Kimi…    │          └─────────────────┘
     │ (10 providers)   │
     └─────────────────┘

エージェントワークフロー

開始 → 初期化とベースライン → メンタリングフェーズ → 実行フェーズ → レビューフェーズ
                                                         ↓
                                               完了？ ──はい→ 完了
                                                  │
                                                  いいえ
                                                  ↓
                                          （メンタリングフェーズへループバック）

---

開発

前提条件

• Node.js 22.22+
• npm または pnpm
• Git
• Rustup（デスクトップビルド用）

[!NOTE] リリースビルドにはGitHub Actionsでアップデータ署名シークレットの設定が必要です。

ビルド前に環境チェックを実行：

npm run preflight

セットアップ

git clone https://github.com/timwuhaotian/the-pair.git
cd the-pair
npm install
npm run dev

プロジェクト構造

the-pair/
├── src/
│   └── renderer/          # React フロントエンド
│       └── src/
│           ├── App.tsx
│           ├── components/
│           └── store/
├── src-tauri/             # Rust バックエンド
│   ├── src/
│   │   ├── lib.rs
│   │   ├── pair_manager.rs
│   │   ├── message_broker.rs
│   │   └── ...
│   └── Cargo.toml
├── build/                 # ビルドリソース
└── package.json

スクリプト

コマンド	説明
npm run dev	ホットリロード開発サーバーを起動
npm run preflight	ローカルビルドの前提条件をチェック
npm run preflight:mac	macOSビルドの前提条件をチェック
npm run preflight:win	Windowsビルドの前提条件をチェック
npm run preflight:linux	Linuxビルドの前提条件をチェック
npm test	JavaScriptおよびRustユニットテスト
npm run test:js	Node/TypeScriptユニットテスト
npm run test:rust	Rustユニットテスト
npm run typecheck	TypeScript型チェック
npm run lint	ESLintを実行
npm run format	Prettierでフォーマット
npm run e2e:setup	Appium macOSドライバーをインストール
npm run e2e	モックE2Eテストを実行
npm run dev:mock	モックエージェントでアプリを起動
npm run dev:smoke	スモークテストモードでアプリを起動
npm run clean	生成されたビルドアーティファクトを削除
npm run build:mac	ローカルmacOS DMGをビルド
npm run build:mac:release	macOSリリースZIPバンドルをビルド
npm run build:win	Windows用ビルド
npm run build:linux	Linux用ビルド

---

FAQ

Q: The Pairは無料でオープンソースですか？

A: はい。The PairはApache 2.0ライセンスの下で完全にオープンソースであり、macOS・Windows・Linux向けに無料でダウンロードできます。費用はご自身のAIプロバイダー利用分のみ——またはOllamaでローカルモデルを実行すればAPIコストはゼロです。

Q: The PairはCursor、GitHub Copilot、Aiderの代替になりますか？

A: はい、ただしアプローチが異なります。Cursor、Copilot、Aiderは単一エージェントで動作します。The Pairは2つの独立したエージェント——Mentor（読み取り専用レビュアー）とExecutor（コード作成者）——を実行し、互いにクロスチェックすることで、ミスが出荷される前に2つ目のモデルが捕捉します。ローカルファーストでオープンソースの代替であり、モデル非依存です：10種類のプロバイダーCLI — opencode、Claude Code、Codex、Antigravity、Kimi Code、Pi、Kiro、Aider、Grok Build、Muse Code — から任意の2つを組み合わせられます。

Q: The Pairはどのオペレーティングシステムに対応していますか？

A: The Pairは macOS・Windows・Linux 向けのネイティブデスクトップアプリで、Tauri 2（Rustバックエンド + Reactフロントエンド）で構築されています。

Q: The PairはシングルエージェントAIコーディングツールとどう違うのですか？

A: シングルエージェントツールは1つのモデルがコードを書いて自己レビューするため、自分のミスを見逃すことがあります。The Pairは2つの独立したエージェントを使用し、MentorがExecutorの作業をレビューすることで、コードが適用される前にエラーを検出します。

Q: The Pairにはインターネット接続が必要ですか？

A: The Pairは完全にローカルで実行されます。AIモデルAPI呼び出しのみインターネットが必要です（またはOllamaでローカルモデルを設定）。

Q: どのAIプロバイダーがサポートされていますか？

A: The Pairは10種類のプロバイダーCLIをそのままサポートしています：opencode（互換性のある任意のモデル）、Claude Code、OpenAI Codex、Antigravity（Gemini）、Kimi Code、Pi、Kiro、Aider、Grok Build、Muse Code。すべてインストール済みCLIから自動検出されます。プロバイダーをミックスできます — 例えばMentorにClaude、ExecutorにCodex。

Q: 自分のAIモデルを使えますか？

A: はい、The Pairはモデルに依存しません。opencodeベースのモデルは互換性のある任意のプロバイダー（OpenAI、Anthropic、Ollamaなど）で動作します。その他のプロバイダーCLIは、CLIをインストールしてサインインするだけです。

Q: エージェントの「思考の深さ」を制御できますか？

A: はい。The Pairはこれを提供するモデルに対して推論努力制御をサポートしています（Claude、Codex、Gemini、Grokなど）。各ロールごとに低/中/高を設定でき、MentorとExecutorは独立して設定可能で、Pair作成時または設定から調整できます。

Q: トークン使用量とコストを追跡するには？

A: トークン使用量はエージェントの各ターンでリアルタイムに追跡されます。リアルタイム出力トークン数はエージェントコンソールにインライン表示され、エージェントの作業中に消費を監視できます。

Q: エージェントがループに陥ったら？

A: The Pairは反復回数制限を実装しています。設定された反復回数に達すると、エージェントは人間の介入のために一時停止します。

Q: アプリがクラッシュしたりセッション中に閉じたら？

A: セッションスナップショットは自動保存されます。再起動時、The Pairは中断されたセッションを検出し、完全な会話履歴付きで復元オプションを提供し、エージェントが中断した場所から再開できるようにします。

Q: The Pairは自動更新されますか？

A: はい。The Pairは起動時に新しいバージョンをチェックし、ワンクリック更新フローで通知します。手動ダウンロードは不要です。

---