v0.1.0¶

Released: 2026-03-28

Initial release of AgentPair - a Go implementation of agent-to-agent pair programming between Claude and Codex.

Highlights¶

🤝 Paired Execution — Claude and Codex work together with one implementing and the other reviewing
🌉 Bridge Communication — JSONL-based messaging with SHA256 deduplication and MCP tool integration
🖥️ Workspace Support — tmux side-by-side panes and git worktree isolation for clean development

What's New¶

Agent Orchestration¶

AgentPair introduces a state machine-based orchestration loop that coordinates between Claude and Codex agents:

init → working → reviewing → working → ... → complete

Paired mode (default): One agent works while the other reviews
Single-agent mode: Run with --claude-only or --codex-only for simpler tasks
Review modes: Choose claude, codex, or claudex (consensus required)

Bridge Communication¶

Agents communicate through a JSONL bridge file with MCP tools:

send_to_agent — Send messages to the other agent
receive_messages — Get pending messages
bridge_status — Check bridge state

Message types include: task, result, review, signal, and chat.

Run Persistence¶

Every run is persisted to ~/.agentpair/runs/:

~/.agentpair/runs/{repo-id}/{run-id}/
├── manifest.json      # Run metadata
├── bridge.jsonl       # Agent messages
└── transcript.jsonl   # Audit log

Resume interrupted runs with --run-id or --session.

Workspace Features¶

tmux support — Side-by-side terminal panes with --tmux
Git worktrees — Isolated environments with --worktree
Live dashboard — Monitor active runs with agentpair dashboard

Installation¶

go install github.com/plexusone/agentpair@v0.1.0

Or build from source:

git clone https://github.com/plexusone/agentpair
cd agentpair
git checkout v0.1.0
go build -o agentpair ./cmd/agentpair

Quick Start¶

# Paired session (Codex works, Claude reviews)
agentpair --prompt "Implement user authentication"

# With tmux side-by-side view
agentpair --tmux --prompt "Add OAuth2 support"

# Single-agent mode
agentpair --claude-only "Fix the bug in login.go"

Configuration¶

Create ~/.agentpair/config.yaml:

agent: codex
max_iterations: 20
review_mode: claudex
use_tmux: false
use_worktree: false

Dependencies¶

Package	Version	Purpose
`github.com/spf13/cobra`	v1.10.2	CLI framework
`github.com/coder/websocket`	v1.8.14	WebSocket client/server
`github.com/modelcontextprotocol/go-sdk`	v1.4.1	MCP integration
`go.yaml.in/yaml/v3`	v3.0.4	YAML configuration

Test Coverage¶

Package	Status
pkg/jsonl	✓
internal/bridge	✓
internal/config	✓
internal/logger	✓
internal/loop	✓
internal/review	✓
internal/run	✓
internal/tmux	✓
internal/worktree	✓

Known Limitations¶

Claude and Codex CLIs must be installed and authenticated separately
Auto-approve mode is enabled by default (run in VM/container for safety)
Integration tests with real agents are not included in this release

Acknowledgments¶

AgentPair is inspired by loop, a TypeScript implementation of the same concept. This Go port provides:

Native binary distribution (no Node.js required)
Structured logging via slog
MCP integration via official Go SDK
Comprehensive test coverage