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 (recommended)

The plugin installs both the herd CLI and the Claude Code skill in one step. Run these slash commands inside a Claude Code session:

❯ /plugin marketplace add generativereality/plugins
  ⎿  Successfully added marketplace: generativereality

❯ /plugin install agentherder@generativereality
  ⎿  ✓ Installed agentherder. Run /reload-plugins to activate.

❯ /reload-plugins
  ⎿  Reloaded: 1 plugin · 0 skills · 5 agents · 0 hooks · 0 plugin MCP servers · 0 plugin LSP servers

Note: These are Claude Code slash commands, not shell commands. Type them at the ❯ prompt inside a Claude Code session.

Via npm (CLI only)

This installs the herd CLI but does not include the Claude Code skill:

npm install -g @generativereality/agentherder

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 the plugin method above, the skill is already included — no extra steps needed.

If you installed via npm and want to add the skill separately:

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

With the skill installed, Claude Code can call herd sessions, herd new, herd fork, and more to orchestrate parallel work autonomously.