Getting Started

Installation

npm i -g groove-ai

Quick Start

Start the daemon:

groove start

Spawn your first agent:

groove spawn --role backend

Spawn a second agent — it will automatically be introduced to the first:

groove spawn --role frontend

Check status:

groove status

What Just Happened

1. groove start launched the daemon on port 3141, which manages all agent coordination
2. Each groove spawn started a Claude Code session with the specified role
3. The introduction protocol notified existing agents about the new arrival
4. The Journalist began synthesizing context in the background

Next Steps

• What is Groove? — understand the architecture
• How It Works — the coordination model in detail
• CLI Reference — all available commands