# Hive

> Docs

Run and manage remote AI coding agents and shell sessions over WebSocket - desktop, mobile, and CLI.

## Table of Contents

### Overview

- [Accounts & Licensing](https://hive.vazac.dev/docs/accounts-licensing.md): Hive accounts and licensing - create an account, manage your password, start the free 14-day trial, activate desktop/mobile devices with a license key, sign in with email or GitHub on web and in the app, manage devices, and understand offline grace and license states.
- [Account Cloud Sync](https://hive.vazac.dev/docs/cloud-sync.md): Account cloud sync - end-to-end encrypted, zero-knowledge sync of saved connection profiles and app settings across Hive apps, including profile deletion and conflict behavior.
- [Architecture](https://hive.vazac.dev/docs/architecture.md): Understand Hive's daemon, clients, session ownership, persistence, streaming, and cluster behavior.
- [Hive compared with Warp](https://hive.vazac.dev/docs/clusto-vs-warp.md): Compare Hive with Warp across remote sessions, agent orchestration, terminal and editor features, deployment, mobile access, and team collaboration.
- [Configuration](https://hive.vazac.dev/docs/configuration.md): Configure Hive daemons, projects, shells, session users, trusted directories, logging, and TLS.
- [CLI Reference](https://hive.vazac.dev/docs/cli.md): Reference for the hive command-line client, including sessions, teams, tasks, files, updates, and daemon administration.
- [Changelog](https://hive.vazac.dev/docs/changelog.md): Follow notable Hive additions, behavior changes, and fixes, including changes available before the next release.
- [Wire Protocol](https://hive.vazac.dev/docs/protocol.md): Reference for Hive client, daemon, cluster, session, task, team, and streaming WebSocket messages.

### Sessions & Transport

- [Terminal Transport & Resume](https://hive.vazac.dev/docs/transport.md): How Hive transports terminal input and output, recovers gaps, and isolates latency across clients and cluster nodes.
- [Session Exclusivity](https://hive.vazac.dev/docs/session-exclusivity.md): How Hive coordinates terminal ownership, input claims, PTY sizing, and passive viewers.
- [Agent Waiting-for-Input Marker](https://hive.vazac.dev/docs/agent-attention.md): The "?" waiting-for-input marker, copy-prompt notifications, and the tool-agnostic contract any AI CLI can use to drive them.
- [Background Notifications (Android)](https://hive.vazac.dev/docs/background-notifications.md): Android background notifications - poll the cluster on a battery-friendly ~15 min timer and surface anything you missed while the app was closed.
- [Remote Log Fetch](https://hive.vazac.dev/docs/remote-log-fetch.md)
- [Mobile Diagnostics](https://hive.vazac.dev/docs/mobile-diagnostics.md)

### Clustering

- [Clustering](https://hive.vazac.dev/docs/clustering.md): Configure and operate Hive's leaderless multi-node clustering, replication, routing, and node resource metrics.
- [Hive Tunnel](https://hive.vazac.dev/docs/clusto-tunnel.md): Hive Tunnel - reach your nodes without Tailscale or port forwarding. A premium feature that gives native apps direct encrypted P2P connectivity (iroh, QUIC hole-punching) and the web app a cloud relay fallback, enabled cluster-wide from Settings > Cluster.
- [Cluster Preferences](https://hive.vazac.dev/docs/cluster-preferences.md)

### App Panels

- [File Explorer](https://hive.vazac.dev/docs/file-explorer.md): Browse and manage project files, upload from the host, and attach clipboard or dropped files to terminal prompts.
- [Git Changes Panel](https://hive.vazac.dev/docs/git-panel.md)
- [Run Panel](https://hive.vazac.dev/docs/run-panel.md)
- [Built-in Editor](https://hive.vazac.dev/docs/editor.md)

### Features

- [Chats](https://hive.vazac.dev/docs/chats.md): Create durable Claude, Codex, OpenCode, or OpenRouter conversations with dedicated workspaces or the shared Notes vault.
- [Design sessions](https://hive.vazac.dev/docs/design-sessions.md): Design UI with an agent that writes self-contained HTML mock screens and renders them live in a preview pane beside the conversation.
- [Agent Docs](https://hive.vazac.dev/docs/agent-docs.md): Review, merge, save, and explicitly roll out tool-specific AI instructions, skills, subagents, and commands across Hive nodes.
- [Files (Whole-Filesystem Explorer)](https://hive.vazac.dev/docs/files-view.md)
- [SSH (Connection Manager)](https://hive.vazac.dev/docs/ssh-view.md)
- [Notes - Markdown vault with chat co-writing](https://hive.vazac.dev/docs/notes.md): Use the Markdown notes vault, rich editor, sync, search, attachments, and first-class multi-provider Notes chats.
- [Tasks](https://hive.vazac.dev/docs/tasks.md): Schedule node-local shell commands, target cluster nodes from the app or CLI, and inspect task runs and output.
- [Teams](https://hive.vazac.dev/docs/teams.md): Create and operate Hive-managed multi-agent teams with authoritative worker rosters, live messaging, and headless orchestration.
- [Teams autopilot](https://hive.vazac.dev/docs/teams-autopilot.md): Understand how Hive leaders create, coordinate, and collect results from managed headless workers through Hive team tools.
- [Appearance & Theming](https://hive.vazac.dev/docs/appearance.md): Configure Hive navigation profiles, item order and density, themes, editor and terminal colors, native OpenRouter credentials, and resizable panels.
- [Terminal Touch Selection (Mobile)](https://hive.vazac.dev/docs/terminal-touch-selection.md)
- [Terminal History & Full Reload](https://hive.vazac.dev/docs/terminal-history.md): How Hive loads, validates, automatically repairs, and fully reloads terminal history.
- [File Path Previews](https://hive.vazac.dev/docs/file-previews.md)

### Web & Updates

- [Web Client (PWA)](https://hive.vazac.dev/docs/web-client.md)
- [Remote-URL Updates](https://hive.vazac.dev/docs/remote-updates.md)

### Reference

- [Cluster Troubleshooting Runbook](https://hive.vazac.dev/docs/troubleshooting.md): Diagnose Hive cluster, daemon, session, authentication, update, and headless team failures.
- [Mobile Keyboard Terminal Behavior](https://hive.vazac.dev/docs/known-issues-mobile-keyboard-menu.md): How Hive handles mobile terminal input, keyboard layout, and history scrolling without resizing the remote PTY.