agentgrid

# agentgrid

[![npm version](https://img.shields.io/npm/v/agentgrid.svg)](https://www.npmjs.com/package/agentgrid)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20WSL-blue.svg)](#works-with)
[![Tests](https://img.shields.io/badge/tests-30%2B%20passing-brightgreen.svg)](#tests)
[![No Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](#how-it-works)

**Your AI agents deserve a proper office.**

One command. Six agents. All working in parallel.

```bash
npx agentgrid 2x3 cursor
```

```
┌──────────────┬──────────────┬──────────────┐
│ ⚡ Agent 1    │ ⚡ Agent 2    │ ⚡ Agent 3    │
│ fixing auth  │ writing tests│ updating docs│
├──────────────┼──────────────┼──────────────┤
│ ✅ Agent 4    │ ⏳ Agent 5    │ ⚡ Agent 6    │
│ done — 3min  │ needs input  │ refactoring  │
└──────────────┴──────────────┴──────────────┘
```

agentgrid creates grids of terminal panes, launches your AI coding agent in each one, and shows you who's working (blue), who's done (green), and who needs you (yellow) — with sound alerts.

Works with **Claude Code, Codex, Cursor CLI, Aider, Goose, Cline, Hermes, Cursor, Cursor**, or literally any terminal command.

<!-- GIF demo: agentgrid 2x3 cursor spawning 6 panes, tasks injected, status colors updating -->

## Install

```bash
npm install -g agentgrid
```

Or with curl:

```bash
curl -fsSL https://raw.githubusercontent.com/naman10parikh/agentgrid/main/install.sh | bash
```

Installs tmux (if needed), configures hooks, sets up sounds. 60 seconds.

**Requirements:** bash, tmux, python3 &middot; **Supports:** macOS &middot; Linux &middot; Windows (WSL)

## Quick Start

```bash
# Same agent in every pane
agentgrid 2x3 cursor

# Interactive wizard — pick agents per pane, save as preset
agentgrid setup

# Launch a saved configuration
agentgrid launch dev-sprint
```

agentgrid auto-detects tmux. If