A hive mind for your sessions: many workers, one queen, nothing slipping through the comb.
HiveTTY Pro is a command center for many agentic coding sessions on one Mac. Every session is a real CLI in a real terminal, unchanged: Claude Code, OpenAI Codex or GitHub Copilot CLI, with the same keys, the same output and the same conversation. Around them sits everything you would otherwise leave the terminal for: an inbox that surfaces the session waiting on you, Jira tickets, pull requests, a file explorer and editor, custom skills, and background agents.
On this page
- What it does
- Quick start
- Plans
- Requirements
- How it fits together
- Documentation
- Development
- Stack
- Licence
Guides (using HiveTTY Pro)
| Start here | Everyday work | Automation | Setup and reference |
|---|---|---|---|
| Getting started | Sessions and terminals | Agents | Settings |
| A tour of the window | The overmind console | The ledger | The config file |
| Troubleshooting | The inbox | Slack | Themes |
| Jira and pull requests | Containers | Updates | |
| Files and the editor | Server mode and remote attach | ||
| Custom skills | The workflow |
Internals (working on HiveTTY Pro): architecture · harnesses · development · every deep dive
| Feature | What it does |
|---|---|
| Runs the terminals | One real PTY per session, on the CLI you pick: Claude Code, Codex or Copilot. Start one from a project, a Jira ticket, or the console: spawn hivetty "fix the lead form". Sessions |
| Notices when one needs you | Each CLI's hooks report in, so a permission prompt or a finished turn raises an inbox card instead of scrolling past in a tab you were not watching. Inbox |
| Keeps the work in view | Jira tickets and gh pull requests, matched to the session that made them. Jira and PRs |
| Opens the repository | A project explorer over the active session's checkout, opening files into a CodeMirror editor. Files |
| Carries your skills | Skill folders under ~/.hivetty/skills reach every session HiveTTY Pro starts, on every CLI, and no other. Skills |
| Runs agents in the background | Headless runs on the CLI and model each agent names, that wake on a schedule, a message or a Slack mention, and ask you before they act. Agents |
| Serves from another Mac | Run sessions on one always-on Mac and drive them from another over Tailscale. Remote |
| Follows a theme all the way down | Chrome, terminal and editor all take their colours from one theme file. Themes |
| Ends cleanly | /done finishes a session and closes its terminal. The row stays readable, with Resume. Sessions |
- Download the
.dmgfrom the latest release (macOS, Apple silicon). It updates itself. - Open it and sign in in your browser. A new account starts a 14-day free trial, no card needed, or choose a plan.
- Click Add a project on Home, and choose a repository folder.
- Click New session, pick a CLI, type the project's name, and press Enter.
That is a live session. The full walkthrough is in Getting started.
HiveTTY Pro needs an account with a plan or a trial. The trial is the Team plan.
| Solo | Team | Enterprise | |
|---|---|---|---|
| Claude Code sessions and agents | ✓ | ✓ | ✓ |
| Codex | ✓ | ✓ | ✓ |
| Copilot | ✓ | ✓ | |
| Shared team ledger | ✓ | ✓ |
A feature your plan does not include is shown locked, with an Upgrade button, never hidden. Your plan, seats, devices and invoices are in Settings › Account center (Settings).
| Need | Why | Without it |
|---|---|---|
| A HiveTTY account | the licence | the window stays on the sign-in screen |
At least one agent CLI on your PATH: claude, codex or copilot, signed in |
every session is a real CLI | that CLI is dimmed in the picker, with the line that installs it |
| git | the branch each session is on | branches read as a dash |
gh, signed in |
the PRs tab | the PRs tab stays empty |
| A Jira account (optional) | the Work tab | the tab says how to connect |
macOS on Apple silicon. Linux and Windows have no release build.
Sessions report their state back through each CLI's own hooks. That is how the inbox knows which one needs you. Every CLI plugs in through one harness port, so the rest of the app never asks which one it is talking to. The long version is in Architecture and Harness architecture.
Everything lives in docs/, in two layers:
- Guides: short, task-first pages with screenshots and examples.
- Internals: the deep dives on how each part is built, for the team working on it.
This repository is private. To work on it:
pnpm install
pnpm desktop:dev # the Electron app with hot reload
pnpm lint && pnpm type-check && pnpm testNode 22 (.nvmrc) and pnpm (pinned in package.json). pnpm lint and
pnpm type-check must both pass before any change is done. The commands, the test layers and
the architecture rules are in Development and AGENTS.md.
React 19 · TypeScript (strict) · Vite · Electron · xterm.js · CodeMirror 6 · Zustand · Tailwind v4 · shadcn/ui · pnpm
Proprietary. Copyright © 2026 Behiques Consulting LLC. All rights reserved. See LICENSE; use of a released build is governed by the End User Licence Agreement (EULA.md, in draft). Open-source components and their licences are listed in NOTICE.