Installation | CodePiper

System Requirements

CodePiper runs on macOS and Linux with the following dependencies:

Dependency	Minimum Version	Purpose
Bun	1.3.5	JavaScript runtime
tmux	3.0	Terminal session management
At least one AI coding CLI	Latest	The agent that runs inside sessions

OS	Architecture
macOS (Darwin)	x64 (Intel), arm64 (Apple Silicon)
Linux	x64, arm64

Windows is not currently supported. Use WSL2 with a Linux distribution for Windows machines.

If you don’t have Bun installed:

curl -fsSL https://bun.sh/install | bash

Verify the version:

bun --version
# Should output 1.3.5 or higher

brew install tmux

sudo apt update && sudo apt install tmux

sudo dnf install tmux

Verify the version:

tmux -V
# Should output tmux 3.0 or higher

CodePiper works with tmux 2.x but some features may behave differently. tmux 3.0+ is recommended.

You need at least one AI coding CLI installed on your system.

npm install -g @anthropic-ai/claude-code

Verify:

claude --version

npm install -g @openai/codex

Verify:

codex --version

You can install both. CodePiper lets you choose the provider when creating each session.

npm i -g codepiper

git clone https://github.com/g3ortega/codepiper.git
cd codepiper
bun install
bun link

The bun link step makes the codepiper command available globally.

Run the built-in diagnostics:

codepiper doctor

This checks:

Platform: OS and architecture compatibility
Bun version: Meets minimum requirement
tmux version: Installed and 3.0+
Provider binaries: Whether claude and/or codex are found in PATH
API key status: Whether ANTHROPIC_API_KEY is set (needed for API billing mode)
Daemon status: Whether the daemon is currently running

A healthy output looks like this:

✓ Platform: darwin arm64
✓ Bun: 1.3.5
✓ tmux: 3.5
✓ claude: found
✓ codex: found
✓ ANTHROPIC_API_KEY: set
✗ Daemon: not running

The daemon not running is expected if you haven’t started it yet.

npm update -g codepiper

cd codepiper
git pull
bun install

After updating, restart the daemon if it’s running:

codepiper daemon stop
codepiper daemon --web

The daemon will re-adopt any running tmux sessions from the previous version.