Hhivey GitHub Install

Coordinate every AI agent you run.

4
agent tools
1
coordinator
100%
open source

Solo agents and whole teams on Claude Code, Codex, Grok and Antigravity. Talk to Hivey, and it designs, launches and checks on every one of them.

Scroll to explore
Overview
GitHub
Open source · macOS + Linux

The coordinator of
all your AI agents.

Solo agents and whole teams, in one terminal. Talk to Hivey: it designs each agent or team with you, launches it, keeps it running and checks on it, so you stop juggling terminals and repeating context.

Works with Claude CodeCodexGrokAntigravity (agy)

⬢
Always onThe Hivey agentYour way into everything, from the terminal, Slack or the pet.
◉
One specialistSolo agentsA long-lived agent with its own folder, brief and memory.
◆
A whole teamSwarmsA coordinator that directs agents in their own space.
↔
All connectedOne message busAgents, leads and Hivey pass work to each other.
01 · Every agent, one coordinator

You talk to Hivey.
Hivey runs the rest.

Hivey isn’t only for swarms. It looks after every agent you run: one-off specialists, long-running solo agents and full teams.

☺YouAn idea, a goal, a question
HHivey agentAlways-on · creates, runs and checks on every agent
◉Solo agents

Each is its own lead: one focused agent for a lasting job, such as marketing, research or a weekly report.

  • Own folder, brief and wiki
  • Own Slack channel
  • Designed with you by the agent creator
◆Swarms (team agents)

A coordinator directs a team of agents, each with its own role, folder and model, in a separate terminal space.

  • Designed with you by the swarm creator
  • Mixed teams: Claude Code, Codex, Grok, agy
  • Scheduled check-ins, dashboard, watcher
⧉Extra sessions

Open a second session of any agent beside the first, or in its own git worktree, and merge the work back when it’s done.

  • Right-click → New session
  • Worktree branch per session
  • Merge back when you exit
02 · How it works

More ambition.
Less terminal juggling.

From a sentence to a working agent or team, and back to you when something needs you.

01

Tell Hivey what’s next.

In its pane, in Slack #hivey or by clicking the pet. It starts a solo agent or a swarm, or hands the work to one that’s already running.

02

Design it together.

A setup provider asks you a few questions, writes each agent’s brief, picks its skills, creates its wiki and launches it.

03

Let the agents coordinate.

Agents message each other; leads and Hivey pass work across teams. Messages wait until an agent is idle, and every message is logged.

04

Stay close. Or step away.

Detach and come back later, check in from Slack, schedule check-ins, or switch on quiet mode for the night. Agents keep working on your machine.

03 · Demo · 48 seconds

From one goal to a morning brief.

Create a swarm, set it up, get the brief in Slack. Animated walkthrough of an example run; unmute for sound.

Open full-size video ↗
04 · Agent map + spend

See what every agent
costs. And how they connect.

One local report of everything that runs on your Mac: which agents and workflows exist, what each one consumes, what failed, and which agent feeds which.

▦

Stats

Tokens and estimated cost per agent, model and provider: Claude Code, Codex, Grok, OpenRouter, the Anthropic API, Gemini. Daily trends, what’s running now, and which jobs failed.

◎

Map

Your workflows as a graph: which job writes the table or folder that another agent reads. Boxes are coloured by spend; click one for what it does, its cost and its last run.

!

Logs

Every scheduled job (cron, launchd) and headless run, with its status, missed runs and the last error line, so you see why something broke.

$

Sessions

What your chats with agents cost, by agent and by day, the costliest sessions and their peak context, plus tips to spend less.

hivey agent-map openor hivey menu → agent map. Pages are served only on your Mac (127.0.0.1). Add a nightly report with hivey agent-map schedule install.

macOS Costs are API-equivalent estimates from your local logs; a subscription plan isn’t billed per token.

05 · The complete workspace

All tools.

Everything included in Hivey. Filter by area, open any card for details.

H

Always-on Hivey agent

Your main way into Hivey. Ask it to launch, check on or message any agent or team.

Details
Set up by the installer in its own first space. When it stops, Hivey starts it again. Reach it in its pane, in Slack #hivey from any device, or through the pet’s chat box.
◉

Solo agents

One long-lived specialist with its own folder, brief, skills and memory.

Details
The built-in agent creator designs one agent with you, writes its brief with checkable deliverables, gives it a wiki and launches it: hivey swarm new --agent "…".
◆

Swarms

A coordinator and its agents, each with a role, in a separate terminal space.

Details
The built-in swarm creator designs the smallest team for the task with you and writes every brief: hivey swarm new "…". Pause, resume or relaunch a whole swarm or one agent.
{ }

Claude Code, Codex, Grok + agy

Mix agent CLIs in one team; each agent runs the tool and model that fits its role.

Details
Each agent needs its own configured access to the tool it runs. Hivey’s lead-agent setup uses Claude Code. The terminal runtime is herdr, credited below.
⚙

Setup providers

Choose how agents and teams are designed, or write your own provider.

Details
Swarm creator, agent creator and an example builder + critic team template ship with Hivey. hivey swarm providers lists them; the provider guide shows how to write one.
⧉

Parallel sessions + worktrees

Run a second session of any agent, optionally in its own git worktree.

Details
Right-click an agent → New session right / below / in worktree. A worktree session works on its own branch; when you exit, it offers to commit and merge back, and stops safely on conflicts.
↔

Agent messaging

Message an agent, a role or a whole team: normal, FYI or urgent.

Details
Normal messages wait until the agent is idle, never mid-task; urgent ones go through now. Messages to an agent stuck on a question are held, and its lead is told. Inboxes and full history.
⏱

Scheduled check-ins

Wake a coordinator or agent every few hours, or at a set time.

Details
--every 2h or --at 09:00, with a status snapshot attached. Delivered only when the agent is idle; paused swarms are skipped. Your machine must stay awake and connected.
▦

Live dashboard

Agent states, token-usage charts, budget, tasks and recent messages in one pane.

Details
A swarm addon that opens beside the team. Close it with q; reopen it any time with hivey swarm addon <swarm> hivey.dashboard.
◎

Agent map + spend

What runs on your Mac, what each agent and workflow costs, and which agent feeds which.

Details
hivey agent-map open builds local Stats, Map, Logs and Sessions pages: tokens and estimated cost per agent, model and provider, daily trends, failing jobs, a dataflow graph of your workflows, and session costs with tips to spend less. macOS.
!

Swarm watcher

Tells the coordinator when an agent is blocked, stalled, stopped or gone.

Details
Also warns when the time budget runs out, and keeps a Gantt view of the swarm’s work.
⌂

GitHub publishing

Publish the product and the swarm’s workspace as two separate repos.

Details
An optional swarm addon, so the code you ship stays apart from the agents’ briefs, notes and logs.
#

Slack

Talk to Hivey in #hivey and to any agent or swarm in its own channel.

Details
In a swarm channel, @agent reaches one agent, @all everyone, and anything else goes to the coordinator. Hivey creates the channels and invites you.
☾

Quiet mode + quiet hours

One switch, or a daily schedule, for silent nights while agents keep working.

Details
No voice, sounds or terminal bell. Slack posts are held and sent as one catch-up message afterwards. hivey quiet schedule 22:30-6:45; voice-only quiet hours too.
H

Desktop pet + chat

A macOS companion that acts out what your agents do. Click it to talk to Hivey.

Details
Choose Hivey (a 3D H), Hivey System (a dot with agents on a signal wave) or Hivey Prompt (a >_ sphere), or none. It reacts to starts, finishes, messages and requests for attention, and reads the important ones aloud.

20-second animated character introduction, not a product recording.

♪

Spoken updates + local voices

Hear agents’ summaries out loud, optionally with local Kokoro voices.

Details
An optional plugin installs local voices on Apple Silicon Macs (about 3 GB of models); nothing is installed until you open it.
◇

Obsidian wiki memory

Every agent or swarm can keep its own linked Markdown wiki.

Details
Sources, findings, decisions and lessons that outlive a chat. Built-in skills add, query, lint and log pages; you can open and edit the vault in Obsidian. Inspired by Karpathy’s LLM Wiki approach ↗.
✦

Skills for every agent

Each new agent gets the skills its job needs, installed in its own folder.

Details
The skills provider picks from Skylls and finds missing ones on skills.sh. Hivey’s own skill teaches agents to run the workspace; others cover Codex, Grok and agy runs, current library docs, and the agent map, which shows every running agent with its token use and estimated cost.
↗

Skylls sharing

Share skills, agents and whole swarm setups with people you choose.

Details
Skylls is a separate integration. Publish a working setup and let recipients import and adapt it; each supplies their own credentials and agent access. Visit Skylls ↗
◈

EnvSave credentials

Agents fetch API keys from EnvSave, so keys stay out of prompts.

Details
Integrations such as the Slack relay retrieve their credentials through the external envsave command. Access still needs configuring.
⌘

Plugins + addons

Extend the workspace; add an addon to a team that’s already running.

Details
Bundled plugins cover swarm and agent creation, skills, the dashboard, the watcher, Slack, GitHub and voices. hivey plugin list; hivey swarm addon <swarm> <plugin>.
⌥

Keyboard + mouse

One key to jump to any team, message an agent, or zoom a pane.

Details
⌥S pick a swarm, ⌥M its coordinator, ⌥A send a message, ⌥I info, ⌥L message log, ⌥F zoom, ⌥P pet. The sidebar shows who is working, needs you or has mail; hover a team for its card.
▣

Sessions per project

Detach and reattach any time; run one Hivey session per project.

Details
⌥Q detaches and agents keep running; hivey reattaches. hivey --session <project> keeps projects apart. Hivey is not a hosted service: the machine must stay awake.
↻

Live updates

hivey update installs the latest version and moves running sessions over.

Details
Agents keep running through the update. npm installs update through npm; source installs pull and rebuild.

Coming soon Per-swarm whiteboards for tasks, shared notes and decisions.

06 · Available now · Open source

Install Hivey.

On an Apple Silicon Mac, install it with npm, then run the setup once. On Linux or an Intel Mac, build it from source. Setup also creates your always-on Hivey agent.

Not ready to install? Save it for your next project.

★ Star Hivey on GitHub
A few good questions
Is Hivey only for swarms?

No. Hivey coordinates every agent you run: solo agents that work alone on a lasting job, swarms with a coordinator and a team, and extra sessions of any agent. The always-on Hivey agent is how you reach all of them.

Is Hivey a model?

No. Hivey is a terminal workspace plus a coordinating agent, built on the herdr terminal runtime. Your agents run tools such as Claude Code, Codex, Grok and Antigravity with your own access to them.

Does it work while my laptop is closed?

Detaching the terminal leaves agents running, but the machine must stay awake and connected. Hivey is not a hosted service that keeps working after your computer sleeps.

Do I have to prompt every agent?

No. Start with Hivey. It creates and manages your agents and teams. When you want the details, talk to any agent or coordinator directly in its terminal space or its Slack channel.

Can I see what my agents cost?

Yes. hivey agent-map open shows every agent, swarm and scheduled job on your Mac with its tokens and estimated cost per model and provider, daily trends, failed jobs, how your workflows feed each other, and what your chat sessions cost. Costs are API-equivalent estimates from local logs, not a bill.

How do I start?

On an Apple Silicon Mac, run npm install -g @hivey/cli, then hivey setup. On Linux or an Intel Mac, get the source from alyssaaa11/hivey on GitHub, install the prerequisites, then run the installer.