DOCUMENTATION

Documentation

Everything about using Hive. New here? Start with getting started. In Hive itself, Ctrl+Space ? lists your keys and Ctrl+Space : finds any command.

• Getting started

  Install Hive, open it, start your first AI coding agents, detach and come back. The concepts you need: daemon, sessions, spaces, worktrees.

• The interface

  What the sidebar, tab bar, status symbols and marks mean, how panes, tabs and spaces work, the mouse, and using Hive from several windows.

• Keys

  Every Hive command with its default key after Ctrl+Space, the prefix-free Alt chords, and how to rebind or unbind any of them in config.toml.

• Configuration

  Every config.toml option with its type and default: general, terminal, daemon, notifications, integrations, worktrees, theme, keys, agents and layouts.

• Command line

  Every hive command and option: new, list, attach, kill, agents, workspace, worktree, report-agent, doctor, update and daemon, with examples.

• Agent status

  How Hive knows an agent is working, needs input or is done, which agents it recognises, the bell and notifications, and how scripts report their own status.

• Workspaces and worktrees

  How Hive groups sessions into spaces by repository, and gives an agent its own git worktree and branch, with the rules that keep your work safe.

• Daemon, files and environment

  What hived does, what survives a crash or reboot, where Hive keeps its files, the environment variables it reads and sets, upgrading and uninstalling.

• Troubleshooting

  Fixes for common Hive problems: keys that do nothing, agents not found, protocol mismatches, odd glyphs or colours, lost sessions, and how to report a bug.

• Integrations

  Obsidian notes, lazygit review, GitHub checks, tasks, desktop notifications, git status and usage: what each does and its options.