Several agents at once

Five agents on one feature. One of them needs you.

Split a feature across several Claude Code sessions and the hard part is no longer the code: it is knowing which terminal is waiting. Grenade runs each agent in a session of its own, groups them by project and gives each one a color.

Install How it works

What you get

Several agents, one view.

A session per agent

One command starts Claude Code in a folder, in a tmux session of its own. Start the API, the UI, the worker, the tests and the docs as five.

A group per project

Sessions in the same folder form a group: one entry on the phone, side by side in the Mac app, one tab in iTerm2 if you use it.

A color for who is waiting

Amber needs an answer, green has finished, blue is working, grey is idle. Claude Code reports it through its own hooks, so nothing is guessed from the screen.

Answer the one that asks

A permission, a question or a plan arrives on your phone as a card. Tap, and that agent goes on while the others keep working.

Not only Claude

Codex and plain shells sit in the same group: a Codex agent on the worker, a shell running the tests.

Nothing stops when you leave

Close the window or walk away: every agent keeps running, and the phone shows where each one is.

On the Mac

Five agents, one project

Each grenade new in the same folder joins that folder's group. --agent picks what runs.

Not installed yet? Two steps on the Mac.

Mac

grenade new api --cwd ~/code/shop --agent claude
grenade new web --cwd ~/code/shop --agent claude
grenade new worker --cwd ~/code/shop --agent codex
grenade new tests --cwd ~/code/shop --agent shell
grenade ls     # every session and its status

Questions

Before you install.

Do the agents get separate git worktrees?

No. Grenade starts each agent in the folder you give it and does not touch your repository. To keep agents apart, give each its own folder or worktree with --cwd, and put them in one group with --with.

How does Grenade know an agent is waiting?

Claude Code and Codex tell the daemon on your Mac through their own hooks, passed for that session only. A plain shell has no hooks, so its status is read from the screen.

Can I see them side by side on the Mac?

Yes. The Grenade Mac app shows a project's agents as panes side by side, and grenade terminal iterm opens each group as an iTerm2 tab with its sessions side by side.

Is this Claude Code's own subagents?

No. These are separate Claude Code sessions, each with its own conversation, that you start and steer yourself. What a session does inside, subagents included, is Claude Code's own.