Skip to main content
the-pair - AI Agents on GitHub (335★) | SkillsLLM
Home AI Agents the-pair The Pair - Automated pair programming — grab a coffee while two AI agents cross-check each other's work
# Add to your Claude Code skills
git clone https://github.com/timwuhaotian/the-pairGuides for using ai agents skills like the-pair.
The Pair
Automated pair programming — grab a coffee while two AI agents cross-check each other's work, built by itself
🌐 English • 简体中文 • 한국어 • 日本語
macOS • Windows • Linux
Watch Mentor and Executor agents collaborate in real-time
Overview
Worried about AI code hallucinations? The Pair solves this by running two AI agents that cross-check each other:
Sign in with GitHub to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
codex-cli
coding
gemini
glm
gpt
harness
kimi
mimo
minimax
opencode
pair-programming
qwen
vibe-coding
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Mentor Agent — Plans, reviews, and validates (read-only)
Executor Agent — Writes code and runs commands
While they work, go grab a coffee. Come back to reviewed, cross-validated code.
Key Benefits
Dual-Model Cross-Validation — Two models check each other's work, dramatically reducing code hallucinations
Cognitive Transparency — Live intent chips and tool call visualization show exactly what each agent is doing
Unified Pair Console — Single scrollable feed merges conversation, timeline, and activity into one cohesive view
Automated Collaboration — Agents work together without constant human intervention
Smart Coordination — Structured handoff prompts, quality gates, and smart pauses keep iterations focused
Real-Time Monitoring — CPU/memory per agent with live activity tracking and stall detection
Operations Panel — Dashboard surfaces attention items, running pairs, resource load, workspaces, and changed files at a glance
Git Integration — Automatic tracking of all file changes plus inline diff viewer for any modified file
Human Oversight — Step in at any time to pause, adjust, reassign, or resume after the iteration limit
Session Recovery — Resume interrupted sessions with full conversation history and turn state restored
Onboarding Wizard — Guided first-time setup with model configuration and directory selection
i18n Support — English, 简体中文, 日本語, and 한국어 with persisted language preference
Dark/Light Themes — Automatic system theme detection with manual toggle
Use Cases
Autonomous coding sessions — Let AI agents iterate on features while you focus on review
Code refactoring — Automated analysis and implementation of improvements
Bug fixing — Agents collaborate to diagnose and resolve issues
Learning tool — Observe how AI agents break down and solve problems
Interrupted work recovery — Restore session state after app restart or crash
Features
Dual-Agent Architecture — Separation of planning (Mentor) and execution (Executor)
Unified Pair Console — Conversation, timeline, terminal events, and activity in one scrollable feed
Cognitive Event Stream — Intent chips, reasoning steps, and tool call status surfaced per turn
Smart Coordination — Structured handoff prompts, quality gates, and smart-pause logic for healthier iterations
Iteration Budgeting — Flat 20-turn default with human-in-the-loop pause when the budget is reached
Full Automation Mode — Agents work autonomously with workspace-scoped permissions
Real-Time Activity Tracking — Live status with stalled-activity detection after 60s of inactivity
Resource Monitoring — CPU and memory usage per agent, updated every second
Git Change Tracking — Detect modified/added/deleted files, with click-through unified diff viewer
Sound Cues — Contextual finish, pause, and error chimes with global mute toggle
Conversation History — Full transcript of all agent interactions, exportable as a run report
Local Orchestration — Runs the app and agent coordination locally; model calls depend on your selected provider or local model
Multi-Provider — Works with opencode, Claude Code, Codex, and Gemini CLI
Reasoning Controls — Adjust thinking effort per agent role (low/medium/high)
Token Tracking — Real-time per-turn input/output token usage in timeline, turn cards, and run reports
Skill System — Attach project-specific skill files to guide agent behavior
Global Shortcuts — Platform-agnostic shortcuts for new pair, pair settings, focus console, and mute
Auto-Update — In-app update checking with one-click install
Screenshots Review Result - Fail With Evidence
Review Result - Pass With Evidence
Installation | Platform | File |
| ----------- | ------------------------------ |
| macOS | the-pair-{version}.zip |
| Windows | the-pair-{version}-setup.exe |
| Linux | the-pair-{version}.AppImage |
From Source git clone https://github.com/timwuhaotian/the-pair.git
cd the-pair
npm install
npm run build:mac # or build:win / build:linux
On macOS, build:mac produces a local DMG, while build:mac:release produces the ZIP-style release bundle used in GitHub Releases. The build script will ensure the required Rust targets are installed before invoking Tauri. If you prefer to set them up manually, run:
rustup target add aarch64-apple-darwin x86_64-apple-darwin
Quick Start
1. Install an AI Provider Install one or more of the supported CLIs:
opencode — curl -fsSL https://opencode.ai/install | bash or npm install -g opencode-ai
Claude Code — see Claude Code setup , or use npm install -g @anthropic-ai/claude-code
Codex — npm install -g @openai/codex
Gemini CLI — npm install -g @google/gemini-cli or npx @google/gemini-cli
2. Configure AI Models (Optional) For opencode-backed models, set up your AI providers in ~/.config/opencode/opencode.json:
{
"provider": {
"openai": { "options": { "apiKey": "your-api-key" } },
"anthropic": { "options": { "apiKey": "your-api-key" } }
}
}
[!TIP]
Codex, Claude Code, and Gemini CLI are detected from their installed CLIs and sign-in state. You can also use local models with Ollama for offline development.
3. Launch The Pair Open from Applications folder or start menu.
4. Create Your First Pair
Click New Pair button
Configure: name, directory, task description, and AI models
Watch the agents work — Mentor plans, Executor implements, Mentor reviews
Monitor progress with real-time activity tracking and file changes
Configuration
Provider Configuration OpenCode-backed models use your existing opencode configuration:
macOS/Linux : ~/.config/opencode/opencode.json
Windows : %APPDATA%/opencode/opencode.json
Codex, Claude Code, and Gemini CLI are detected from their local CLI install and account state.
Pair Runtime Each pair maintains its own runtime configuration in .pair/runtime/<pairId>/ within your project directory, including session files, runtime permissions, and conversation history.
[!NOTE]
The Pair does not modify your global opencode permissions. All permissions are session-specific.
Architecture
Tech Stack | Layer | Technology |
| -------------- | --------------------- |
| Framework | Tauri 2.x |
| Backend | Rust |
| Frontend | React 19 + TypeScript |
| Styling | Tailwind CSS v4 |
| State | Zustand |
| Animations | Framer Motion |
| Icons | Lucide React |
System Architecture ┌─────────────────────────────────────────────────────────┐
│ The Pair App │
├─────────────────────────────────────────────────────────┤
│ Frontend (React UI) │
│ ┌──────────────┬──────────────┬──────────────────┐ │
│ │ Dashboard │ PairConsole │ Settings │ │
│ │ (Ops Panel) │ (Unified) │ (Onboarding) │ │
│ └──────────────┴──────────────┴──────────────────┘ │
│ ↕ Tauri IPC │
├─────────────────────────────────────────────────────────┤
│ Backend (Rust) │
│ ┌──────────────┬──────────────┬──────────────────┐ │
│ │ PairManager │MessageBroker │
57,837
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
CompareThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
CompareThe agent that grows with you
AI Agents ai ai-agent
CompareClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
AI Agents
CompareAn open-source AI agent that brings the power of Gemini directly into your terminal.
AI Agents ai ai-agents
Compare