Skip to content

Installation

Prerequisites

Before installing AgentPair, ensure you have:

  • Go 1.21+ — Required for building from source
  • claude CLI — Claude Code installed and logged in
  • codex CLI — OpenAI Codex installed and logged in

Optional:

  • tmux — For side-by-side agent view
  • Git — For worktree isolation feature

Install with Go

go install github.com/plexusone/agentpair@latest

Ensure $GOPATH/bin is in your PATH:

export PATH="$GOPATH/bin:$PATH"

Build from Source

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

Move to a directory in your PATH:

mv agentpair ~/.local/bin/

Verify Installation

agentpair version

Agent Setup

Claude CLI

Install Claude Code following the official documentation:

# Verify claude is working
claude --version

Codex CLI

Install OpenAI Codex following the official documentation:

# Verify codex is working
codex --version

Safety Note

AgentPair runs agents in auto-approve mode by default. Consider running inside a VM or container for safety. The agents can execute commands and modify files.

tmux (Optional)

For the side-by-side view feature:

brew install tmux

sudo apt install tmux

sudo dnf install tmux

Verify:

tmux -V

Next Steps