# hive

> A terminal multiplexer for agent-heavy work. Every docs page is also Markdown at the same address plus .md.

To set up hive and its skills for an agent, follow http://manueltarouca.github.io/hive/agent-setup/prompt.md


## Start

- [Installation](http://manueltarouca.github.io/hive/docs/installation.md): Download hive for macOS, Linux or Android, or build it from source.
- [Getting started](http://manueltarouca.github.io/hive/docs/getting-started.md): Your first ten minutes with hive: a session, a restart, and an agent you can see.
- [Agent setup](http://manueltarouca.github.io/hive/docs/agent-setup.md): Let your coding agent install hive, learn its commands, and move your tmux work over.

## Use hive

- [Sessions, tabs and panes](http://manueltarouca.github.io/hive/docs/sessions.md): What a session, a tab and a pane are, and how commands choose which one to act on.
- [The Mac app](http://manueltarouca.github.io/hive/docs/app.md): The macOS app, its shortcuts, and how it draws your terminals.
- [Agents](http://manueltarouca.github.io/hive/docs/agents.md): Claude Code and other agents in hive, their status, and how they come back after a restart.
- [Restarts](http://manueltarouca.github.io/hive/docs/restarts.md): What hive keeps on disk, and what comes back after a restart or a reboot.
- [Remote hosts](http://manueltarouca.github.io/hive/docs/remote.md): Run hive on other machines and use them from your Mac or phone over your tailnet.
- [hive on your phone](http://manueltarouca.github.io/hive/docs/android.md): hive for Android: your sessions and agents on the phone, over your tailnet.
- [Settings](http://manueltarouca.github.io/hive/docs/settings.md): The settings file, what each setting does, and how the app applies changes.

## Automate

- [The CLI](http://manueltarouca.github.io/hive/docs/cli.md): Every hive command, its options, and its exit codes.
- [Server API](http://manueltarouca.github.io/hive/docs/api.md): The methods the server offers, how to call them, and the events it sends.
- [Scripts](http://manueltarouca.github.io/hive/docs/scripts.md): Run TypeScript on the server to set up panes, react to events and drive your agents.
- [Attach protocol](http://manueltarouca.github.io/hive/docs/attach.md): How a client mirrors terminals: snapshots, ordered output, resizes, and resyncs.
- [Program status](http://manueltarouca.github.io/hive/docs/program-status.md): How programs tell hive what they are doing, with OSC 7501.

## Help

- [Troubleshooting](http://manueltarouca.github.io/hive/docs/troubleshooting.md): What to do when hive doesn't start, an agent doesn't show, or a host doesn't connect.
- [Questions](http://manueltarouca.github.io/hive/docs/faq.md): Does hive replace tmux? Why Tailscale? Which agents? Short answers.
- [Privacy](http://manueltarouca.github.io/hive/docs/privacy.md): What hive collects (nothing), and what it connects to.