CLI Commands
groove start
Start the Groove daemon.
bash
groove startLaunches the daemon on port 3141. Serves the GUI and exposes the REST/WebSocket API.
groove stop
Stop the daemon.
bash
groove stopgroove spawn
Spawn a new agent.
bash
groove spawn --role <role> [--scope <glob>] [--model <model>]| Flag | Description | Default |
|---|---|---|
--role | Agent role (e.g., backend, frontend, database) | Required |
--scope | File glob for ownership (e.g., "src/api/**") | None |
--model | Lock to a specific model | Auto-routed |
groove kill
Kill an agent.
bash
groove kill <agent-id>groove agents
List all active agents.
bash
groove agentsgroove status
Show daemon status, active agents, and session stats.
bash
groove statusgroove nuke
Emergency stop — kill all agents and stop the daemon.
bash
groove nukegroove team save
Save current agent configuration as a team.
bash
groove team save <name>groove team load
Load a saved team configuration.
bash
groove team load <name>groove team list
List saved teams.
bash
groove team list