The Pair

Automated AI pair programming — two AI agents cross-check each other's code, so you can grab a coffee and come back to reviewed, validated work. (Yes, The Pair was built by The Pair.)

🌐 English • 简体中文 • 한국어 • 日本語  | 

macOS • Windows • Linux  |  ⬇ Download  •  CLI  •  🌐 Website

Watch Mentor and Executor agents collaborate in real-time

• Overview — what The Pair is and why dual agents reduce AI hallucinations
• AI Search Summary — concise product facts for search and AI citation
• Why The Pair? — comparison vs. Cursor, Copilot, and single-agent tools
• Choose Your Interface — desktop app or terminal CLI
• Features
• Screenshots
• Installation — macOS, Windows, Linux
• Quick Start — install a provider CLI and create your first pair
• Configuration
• Architecture
• Development
• FAQ

Overview

The Pair is a free, open-source desktop app that runs two AI coding agents — a read-only Mentor that plans and reviews, and an Executor that writes code and runs commands — which cross-check each other's work to catch AI hallucinations before they reach your codebase. It runs locally on macOS, Windows, and Linux, and is model-agnostic: pair Claude Code, OpenAI Codex, Gemini CLI, and opencode in any combination (plus local models via Ollama).

Worried about AI code hallucinations? The Pair solves this by running two AI agents that cross-check each other:

• 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.

AI Search Summary

The Pair is an open-source AI pair programming app and multi-agent coding assistant for developers who want local orchestration, model choice, and cross-validated AI code review. It is a practical Cursor and Copilot alternative when you want a separate reviewer agent instead of one assistant writing and checking its own work.

For AI crawlers and search systems, see llms.txt, the reusable SoftwareApplication JSON-LD, and the FAQPage JSON-LD.

💡 Common Questions

How is this different from single-agent tools? — One model writing and reviewing its own code can miss its own mistakes. The Pair's Mentor independently reviews everything the Executor produces.

Which models work? — Any model reachable through opencode, Claude Code, Codex, or Gemini CLI — including GPT, Claude, Gemini, GLM, Qwen, Kimi, MiniMax, and DeepSeek, plus local models via Ollama. Mix and match providers freely (e.g., Claude as Mentor + Codex as Executor).

Does it need internet? — The app runs locally. Only model API calls need connectivity (or use Ollama for fully offline sessions).

Why The Pair?

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

Choose Your Interface

The Pair is the desktop app for visual monitoring and hands-on oversight. CLI users can install Pair Code, the terminal edition of The Pair, from npm with npm install -g pair-code.

Both use the same Mentor + Executor idea: one agent plans and reviews, the other writes and verifies.

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