Getting Started

Prerequisites

• Wave Terminal (macOS)
• Claude Code — claude on your PATH
• Node.js ≥ 20

One-time setup: Wave Terminal needs Accessibility permission to open new tabs:

System Settings → Privacy & Security → Accessibility → Wave Terminal ✓

Install

As a Claude Code plugin (installs the CLI + skill in one step):

/plugin marketplace add generativereality/plugins
/plugin install agentherder@generativereality

Via npm (CLI only):

npm install -g @generativereality/herd

Verify:

herd --version

First session

From inside Wave Terminal:

herd sessions

This shows all open tabs and whether they have active Claude Code sessions.

Open a new session:

herd new myproject ~/Dev/myproject

herd will:

1. Open a new Wave tab
2. Rename it to myproject
3. cd to ~/Dev/myproject
4. Launch claude --name myproject

The tab title and Claude session name are in sync from the start.

Add the Claude Code skill

If you installed via npm rather than the plugin, add the skill manually:

mkdir -p .claude/skills/herd
curl -fsSL https://raw.githubusercontent.com/generativereality/agentherder/main/skills/herd/SKILL.md \
  -o .claude/skills/herd/SKILL.md

Now Claude Code can call herd sessions, herd new, herd fork, and more to orchestrate parallel work.