>_

Multiplayer AI Coding

Your team's laptops. One AI-powered fleet.

[
]

Code together. Apart.

Anyone triggers a task. Any idle machine picks it up. Every change becomes a PR the whole team reviews. It's pair programming—multiplied.

Why go multiplayer?

solo-mode.log

[--]Solo Mode

  • -One machine. One AI session.
  • -Everyone else waits.
  • -Changes stuck on one branch.
multiplayer-mode.log

[++]Multiplayer Mode

  • +Any machine. Any time.
  • +Parallel AI sessions.
  • +PRs for the whole team.

The Players

Self-Hosted Runners

Your laptops, ready to work.

GitHub Actions

Orchestrates the magic.

Ralph Script

Keeps the AI in the loop.

Claude Code

Does the actual coding.

step-1.md
[1]

Trigger

Someone kicks off an AI task

Via GitHub Actions UI, CLI command, or Slack bot. The task gets queued as a workflow_dispatch event.

gh workflow run ai-pair.yml \
  -f task="Add input validation"

What You Need

~/your-repo/
├── .github//
│ └── workflows//
│ └── ai-pair.yml# GitHub Actions workflow
├── scripts//
│ └── ralph.sh# Runs Claude Code in a loop
└── README.md

Setup Checklist

setup.sh
[1]

Install Claude Code CLI on each dev machine

$brew install claude-code
[2]

Authenticate Claude Code

$claude auth login
[3]

Register machines as GitHub self-hosted runners

$./config.sh --url https://github.com/org/repo
[4]

Add ai-pair.yml workflow to your repo

Copy the workflow file to .github/workflows/

[5]

Add ralph.sh script to your repo

Copy the script to scripts/

[6]

Start runners on participating machines

$./run.sh