Get your agent team running
Install HiveTerm, define your bees in a hive.yml, and start orchestrating. Everything here works on macOS, Windows and Linux.
Quickstart
Install
Download the app for your OS and open it, that's the whole install.
Add a project
Open a project folder. HiveTerm auto-detects your stack and offers a starter hive.yml.
Start
Open the project, every auto-start bee boots and coordinates through the Queen.
Routines
A routine is a task on a schedule, sent into an agent you already have. It lands in that bee's live conversation. If the agent is stopped, HiveTerm starts it. If it's busy, HiveTerm interrupts and injects.
Your first routine
Open Routines
Hit ⌘⇧R, or the + row under Routines in the project tree. You need a project open, and at least one agent in it.
Pick the agent and write the task
Choose a bee from the sidebar, then write what it should do each run. "Summarize what landed on main since yesterday" is enough to start.
Pick when
Daily, weekdays, weekly, or every few hours, in your timezone. Missed slots can run when the app opens, or skip to the next time.
Run now, or wait
Save it and let the schedule fire, or hit Run now. The task shows up in that agent's tab. You can watch, reply, or walk away.
Templates to start from
Morning briefing What changed since yesterday: commits, PRs, issues, and what needs you. Issue triage Read new issues, label them, flag the ones that block you. Dependency audit Check outdated and vulnerable packages, write down what to bump. Weekly changelog Draft release notes from the week's commits and merged PRs. Test health Run the suite, report failures, point at the first file to open. Branch cleanup List stale branches and say which ones are safe to delete. Routines live on the project. Pause, edit, duplicate to another project, or delete from the sidebar. An agent can create and manage them through Hive, the same actions you see in the UI. Free includes 2; Pro is unlimited.
The hive.yml
One file per project defines your agents and processes. Commit it so your whole team shares the same workspace.
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. Agents call it to spawn helpers, ask each other, run routines, read output, manage pins and notes, and notify you. 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 create_agent Add a lasting agent to the sidebar ask_bee Ask another agent and wait for the reply here create_routine Schedule a task on a live agent list_routines See routines in this project update_routine Pause, rename, or change the schedule delete_routine Remove a routine and its run history run_routine Fire it now into that agent's tab list_pins List the pins on any project board create_pin Pin a message or its own plan to the board update_pin Edit a pin's title or body set_pin_done Check a pin off when the work is done delete_pin Remove a pin from the board get_notes Read a project's notes scratchpad set_notes Replace a project's notes append_notes Append a line to a project's notes send_message Send a structured message to another agent read_inbox Receive messages from other agents, no scraping reply Answer a message, correlated to its thread await_reply Block until another agent answers How agents talk
ask_bee is the one you see: from CEO, ask CTO, the question appears in CTO's tab, the answer comes back here. Under that, send_message / read_inbox / reply / await_reply still exist for structured hand-offs that never scrape a terminal. Prefer ask_bee when you want the other agent to actually work the question in its session.
Spawn controls
spawn_bee accepts two opt-in flags: model pins the spawned agent to a specific model (omit it to let the orchestrator decide), and skip_permissions starts the agent with its permission prompts bypassed, each CLI gets its own flag injected (Claude, Codex and Antigravity all supported). read_output additionally accepts encoding:"screen" to replay the terminal as a rendered VT100 screen instead of raw bytes.
Splits & files
Split groups pair your agents side by side, create one from the sidebar (two ungrouped agents required), drag panes by their grip to reposition or swap, and save layouts with a name. Selecting any member brings the whole split back.
The file explorer opens anything: code gets syntax highlighting with VSCode-style search and in-place editing (⌘S, atomic saves), huge files switch to a virtualized viewer with text search, and images, markdown and binaries each get a proper view.
Need more?
Check the changelog for the latest, or just download and explore, most of HiveTerm is discoverable in the app.