Docs
Get your swarm running
Install HiveTerm, define your bees in a hive.yml, and start orchestrating. Everything here works on macOS, Windows and Linux.
Quickstart
1
Install
Download the app for your OS and open it — that's the whole install.
2
Add a project
Open a project folder. HiveTerm auto-detects your stack and offers a starter hive.yml.
3
Start
Open the project — every auto-start bee boots and coordinates through the Queen.
The hive.yml
One file per project defines your agents and processes. Commit it so your whole team shares the same workspace.
hive.yml
name: My App
bees:
claude:
type: agent
command: claude
instructions: "Senior engineer. Ship clean PRs."
api:
command: npm run dev
cwd: ./server
auto_start: true
restart_on_change: ["src/**"]
env:
PORT: 5173| Field | What it does |
|---|---|
name | Project name shown in the sidebar. |
command | The shell command to run for this bee. Required. |
type | "agent" for AI CLIs, "command" for everything else. |
cwd | Working directory for the bee (defaults to the project root). |
env | Environment variables injected when the bee spawns. |
auto_start | Boot this bee automatically when the project opens. |
auto_restart | Restart the bee when it exits with a non-zero code. |
restart_on_change | Restart the bee when files matching these globs change. |
instructions | System-prompt instructions injected into an agent at startup. |
The Queen (MCP server)
A local MCP server on an automatically chosen port. Your agents call these 8 tools to spawn sub-agents, read output, and notify you — all isolated per project.
spawn_bee Create new processes and agents on the fly kill_bee Stop any running process restart_bee Restart crashed or stale processes list_bees See all processes across projects get_bee_status Check health and uptime of any bee read_output Read terminal output from any process write_input Send input to running processes notify Push native desktop notifications Need more?
Check the changelog for the latest, or just download and explore — most of HiveTerm is discoverable in the app.