Skip to content
eduwassPublic

About

Layout for Claude Code agent teams, fixed.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

◫ 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    │
│                  │                │                │
╰──────────────────┴────────────────┴────────────────╯

demo

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
  1. 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

About

Layout for Claude Code agent teams, fixed.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages