◫ cru

Layout for Claude Code agent teams, fixed.

Agent teams let multiple Claude Code instances work together in parallel — cru handles the terminal layout so you don't have to.

╭──────────────────┬────────────────┬────────────────╮
│                  │                │                │
│                  │  ⚡ worker-1    │  ⚡ worker-2    │
│                  │                │                │
│       lead       ├────────────────┼────────────────┤
│                  │                │                │
│                  │  ⚡ worker-3    │  ⚡ worker-4    │
│                  │                │                │
╰──────────────────┴────────────────┴────────────────╯

Terminal setup

• Already using tmux? You're good.
• iTerm2? Use tmux -CC for native pane integration.
• Ghostty? Workers still run in tmux (that's how Claude Code spawns agents), but cru mirrors them into native Ghostty splits via AppleScript — so you get Ghostty's UI instead of working inside tmux yourself. Requires Ghostty v1.3.0+.
• cmux? Native support — cru mirrors workers into cmux splits via the cmux CLI socket. Tabs get labeled with ◫ (lead) and ⚡ (workers) for quick identification. Auto-detected when running inside cmux.

Install

npm install -g cru-teams

pnpm add -g cru-teams

bun add -g cru-teams

Quick start

1. Set up cru in your project:

cru init

2. In Claude Code, spawn a team:

/cru split the auth module into subtasks and parallelize across workers

That's it — cru creates the panes, applies the grid layout, and your workers are ready to go.

Use cases

Parallel feature work — split subtasks across workers, merge when done

/cru break down the checkout flow into vertical slices, one worker per slice

Review crew — workers build, one reviews

/cru 3 review PR #142 — one on security, one on performance, one on test coverage

Competing hypotheses — debug faster with multiple theories at once

/cru users report the app crashes on login — each worker investigates a different theory

Research spike — explore different approaches simultaneously

/cru 3 evaluate auth libraries — one on passport, one on lucia, one on arctic

Documentation

• CLI reference — all commands, flags, and examples
• Configuration — layout options, config files, resolution order
• Testing — test structure and how to run tests