# Reeve Docs

- [Reeve Documentation](/docs): Reeve is your AI business operating system — analytics, ads, email, social, support, and recruiting, all in one place.
- [Connectors API](/docs/api/connectors): OAuth flows, available connectors, API key management, and webhook setup for third-party integrations.
- [API Overview](/docs/api/overview): Services API overview — authentication, base URL, rate limits, and how agents interact with external platforms.
- [API Keys](/docs/auth/api-keys): Manage LLM provider keys, understand BYOK vs managed models, and configure auth profiles.
- [Authentication](/docs/auth): How authentication works in Reeve — sign up, sign in, team invites, and API access.
- [Authentication Overview](/docs/auth/overview): How Reeve handles authentication — Clerk for users, session tokens for APIs, and service-to-service auth.
- [API Reference](/docs/agents/api-reference): Agent management JSON-RPC bridge methods and CLI commands.
- [Agent Configuration](/docs/agents/configuration): Per-agent model selection, heartbeat schedules, tool policies, and config inheritance.
- [Creating Agents](/docs/agents/creating-agents): Create new agents using the CLI wizard, non-interactive mode, or JSON-RPC API.
- [Agent Management](/docs/agents): Create, configure, and manage AI agents with role-based templates and lifecycle tools.
- [Agent Memory](/docs/agents/memory): How Reeve agents remember things — workspace files, daily logs, semantic search, and memory flush.
- [Multi-Agent Coordination](/docs/agents/multi-agent): Spawn sub-agents, delegate work, and orchestrate complex tasks across multiple agents.
- [Agent Overview](/docs/agents/overview): What Reeve agents are, how roles work, and the difference between built-in and custom agents.
- [Agent Tools](/docs/agents/tools): Available tools for Reeve agents, tool profiles, and how to create custom tools.
- [Auth monitoring](/docs/automation/auth-monitoring): Monitor OAuth expiry for model providers
- [Cron jobs (Gateway scheduler)](/docs/automation/cron-jobs): Cron jobs + wakeups for the Gateway scheduler
- [Cron vs Heartbeat: When to Use Each](/docs/automation/cron-vs-heartbeat): Guidance for choosing between heartbeat and cron jobs for automation
- [Gmail Pub/Sub -> Reeve](/docs/automation/gmail-pubsub): Gmail Pub/Sub push wired into Reeve webhooks via gogcli
- [Hooks](/docs/automation/hooks): Hooks: event-driven automation for commands and lifecycle events
- [Polls](/docs/automation/poll): Poll sending via gateway + CLI
- [Webhooks](/docs/automation/webhook): Webhook ingress for wake and isolated agent runs
- [BlueBubbles (macOS REST)](/docs/channels/bluebubbles): iMessage via BlueBubbles macOS server (REST send/receive, typing, reactions, pairing, advanced actions).
- [Broadcast Groups](/docs/channels/broadcast-groups): Broadcast a WhatsApp message to multiple agents
- [Discord (Bot API)](/docs/channels/discord): Discord bot support status, capabilities, and configuration
- [Google Chat (Chat API)](/docs/channels/googlechat): Google Chat app support status, capabilities, and configuration
- [grammY Integration (Telegram Bot API)](/docs/channels/grammy): Telegram Bot API integration via grammY with setup notes
- [iMessage (imsg)](/docs/channels/imessage): iMessage support via imsg (JSON-RPC over stdio), setup, and chat_id routing
- [Chat Channels](/docs/channels): Messaging platforms Reeve can connect to
- [Channel location parsing](/docs/channels/location): Inbound channel location parsing (Telegram + WhatsApp) and context fields
- [Matrix (plugin)](/docs/channels/matrix): Matrix support status, capabilities, and configuration
- [Mattermost (plugin)](/docs/channels/mattermost): Mattermost bot setup and Reeve config
- [Microsoft Teams (plugin)](/docs/channels/msteams): Microsoft Teams bot support status, capabilities, and configuration
- [Nextcloud Talk (plugin)](/docs/channels/nextcloud-talk): Nextcloud Talk support status, capabilities, and configuration
- [Nostr](/docs/channels/nostr): Nostr DM channel via NIP-04 encrypted messages
- [Signal (signal-cli)](/docs/channels/signal): Signal support via signal-cli (JSON-RPC + SSE), setup, and number model
- [Slack](/docs/channels/slack): Slack setup for socket or HTTP webhook mode
- [Telegram (Bot API)](/docs/channels/telegram): Telegram bot support status, capabilities, and configuration
- [Tlon (plugin)](/docs/channels/tlon): Tlon/Urbit support status, capabilities, and configuration
- [Channel troubleshooting](/docs/channels/troubleshooting): Channel-specific troubleshooting shortcuts (Discord/Telegram/WhatsApp)
- [WhatsApp (web channel)](/docs/channels/whatsapp): WhatsApp (web channel) integration: login, inbox, replies, media, and ops
- [Zalo (Bot API)](/docs/channels/zalo): Zalo bot support status, capabilities, and configuration
- [Zalo Personal (unofficial)](/docs/channels/zalouser): Zalo personal account support via zca-cli (QR login), capabilities, and configuration
- [acp](/docs/cli/acp): Run the ACP bridge for IDE integrations
- [reeve agent](/docs/cli/agent): CLI reference for `reeve agent` (send one agent turn via the Gateway)
- [reeve agents](/docs/cli/agents): CLI reference for `reeve agents` (list/add/delete/set identity)
- [reeve approvals](/docs/cli/approvals): CLI reference for `reeve approvals` (exec approvals for gateway or node hosts)
- [reeve browser](/docs/cli/browser): CLI reference for `reeve browser` (profiles, tabs, actions, extension relay, remote serve)
- [reeve channels](/docs/cli/channels): CLI reference for `reeve channels` (accounts, status, login/logout, logs)
- [reeve cockpit](/docs/cli/cockpit): CLI reference for `reeve cockpit` (open the Control UI)
- [reeve config](/docs/cli/config): CLI reference for `reeve config` (get/set/unset config values)
- [reeve configure](/docs/cli/configure): CLI reference for `reeve configure` (interactive configuration prompts)
- [reeve cron](/docs/cli/cron): CLI reference for `reeve cron` (schedule and run background jobs)
- [reeve cockpit](/docs/cli/dashboard): CLI reference for `reeve cockpit` (open the Control UI)
- [reeve devices](/docs/cli/devices): CLI reference for `reeve devices` (device pairing + token rotation/revocation)
- [reeve directory](/docs/cli/directory): CLI reference for `reeve directory` (self, peers, groups)
- [reeve dns](/docs/cli/dns): CLI reference for `reeve dns` (wide-area discovery helpers)
- [reeve doctor](/docs/cli/doctor): CLI reference for `reeve doctor` (health checks + guided repairs)
- [Gateway CLI](/docs/cli/gateway): Reeve Gateway CLI (`reeve gateway`) — run, query, and discover gateways
- [reeve health](/docs/cli/health): CLI reference for `reeve health` (gateway health endpoint via RPC)
- [reeve hooks](/docs/cli/hooks): CLI reference for `reeve hooks` (agent hooks)
- [CLI reference](/docs/cli): Reeve CLI reference for `reeve` commands, subcommands, and options
- [reeve logs](/docs/cli/logs): CLI reference for `reeve logs` (tail gateway logs via RPC)
- [reeve memory](/docs/cli/memory): CLI reference for `reeve memory` (status/index/search)
- [reeve message](/docs/cli/message): CLI reference for `reeve message` (send + channel actions)
- [reeve models](/docs/cli/models): CLI reference for `reeve models` (status/list/set/scan, aliases, fallbacks, auth)
- [reeve node](/docs/cli/node): CLI reference for `reeve node` (headless node host)
- [reeve nodes](/docs/cli/nodes): CLI reference for `reeve nodes` (list/status/approve/invoke, camera/canvas/screen)
- [reeve onboard](/docs/cli/onboard): CLI reference for `reeve onboard` (interactive onboarding wizard)
- [reeve pairing](/docs/cli/pairing): CLI reference for `reeve pairing` (approve/list pairing requests)
- [reeve plugins](/docs/cli/plugins): CLI reference for `reeve plugins` (list, install, enable/disable, doctor)
- [reeve reset](/docs/cli/reset): CLI reference for `reeve reset` (reset local state/config)
- [Sandbox CLI](/docs/cli/sandbox): Manage sandbox containers and inspect effective sandbox policy
- [reeve security](/docs/cli/security): CLI reference for `reeve security` (audit and fix common security footguns)
- [reeve sessions](/docs/cli/sessions): CLI reference for `reeve sessions` (list stored sessions + usage)
- [reeve setup](/docs/cli/setup): CLI reference for `reeve setup` (initialize config + workspace)
- [reeve skills](/docs/cli/skills): CLI reference for `reeve skills` (list/info/check) and skill eligibility
- [reeve status](/docs/cli/status): CLI reference for `reeve status` (diagnostics, probes, usage snapshots)
- [reeve system](/docs/cli/system): CLI reference for `reeve system` (system events, heartbeat, presence)
- [reeve tui](/docs/cli/tui): CLI reference for `reeve tui` (terminal UI connected to the Gateway)
- [reeve uninstall](/docs/cli/uninstall): CLI reference for `reeve uninstall` (remove gateway service + local data)
- [reeve update](/docs/cli/update): CLI reference for `reeve update` (safe-ish source update + gateway auto-restart)
- [reeve voicecall](/docs/cli/voicecall): CLI reference for `reeve voicecall` (voice-call plugin command surface)
- [reeve webhooks](/docs/cli/webhooks): CLI reference for `reeve webhooks` (webhook helpers + Gmail Pub/Sub)
- [Architecture](/docs/cloud/architecture): Docker per-tenant containers, Traefik routing, S3 persistence, and EC2 infrastructure.
- [Authentication](/docs/cloud/authentication): Clerk-powered authentication with magic links, session tokens, and service-to-service auth.
- [Billing & Credits](/docs/cloud/billing): Credit-based billing, tier metering, usage quotas, and Stripe integration.
- [Deployment](/docs/cloud/deployment): Setting up a Reeve Cloud deployment on AWS with Docker and Traefik.
- [Reeve Cloud](/docs/cloud): Managed cloud platform with per-tenant isolation, authentication, and billing.
- [Tenant Isolation](/docs/cloud/tenant-isolation): How Reeve Cloud isolates workspaces, data, and execution between tenants.
- [App Store](/docs/cockpit/app-store): Marketplace for Reeve extensions, integrations, and agent capabilities.
- [Brand Intelligence](/docs/cockpit/brand-intelligence): AI-powered brand analysis, competitor monitoring, ad intelligence, and market insights.
- [Connectors](/docs/cockpit/connectors): Step-by-step setup guides for every Reeve connector — where to find API keys, how to authenticate, and what data you get.
- [Dashboard](/docs/cockpit/dashboard): Unified analytics dashboard with KPIs from 7 data sources, alert ribbons, and real-time panels.
- [Cockpit](/docs/cockpit): The web dashboard for managing agents, analytics, brand intelligence, and integrations.
- [Keyboard Shortcuts](/docs/cockpit/keyboard-shortcuts): Navigate the Cockpit faster with keyboard shortcuts.
- [Mission Control](/docs/cockpit/mission-control): Monitor active sessions, agent status, and use the command bar for quick actions.
- [Cockpit Overview](/docs/cockpit/overview): A guided tour of the Reeve Cockpit — dashboard, chat, navigation, and key features.
- [Settings](/docs/cockpit/settings): Gateway configuration, LLM provider management, agent settings, and billing from the Cockpit.
- [Agent Loop (Reeve)](/docs/concepts/agent-loop): Agent loop lifecycle, streams, and wait semantics
- [Agent workspace](/docs/concepts/agent-workspace): Agent workspace: location, layout, and backup strategy
- [Agent Runtime 🤖](/docs/concepts/agent): Agent runtime, workspace contract, and session bootstrap
- [Gateway architecture](/docs/concepts/architecture): WebSocket gateway architecture, components, and client flows
- [Channels & routing](/docs/concepts/channel-routing): Routing rules per channel (WhatsApp, Telegram, Discord, Slack) and shared context
- [Context Window & Compaction](/docs/concepts/compaction): Context window + compaction: how Reeve keeps sessions under model limits
- [Context](/docs/concepts/context): Context: what the model sees, how it is built, and how to inspect it
- [Cron & Automation](/docs/concepts/cron-jobs): Schedule recurring tasks, set reminders, automate reports, and wake agents on a schedule.
- [Goals](/docs/concepts/goals): Persistent, multi-phase objectives that drive autonomous agent work across sessions.
- [Group messages (WhatsApp web channel)](/docs/concepts/group-messages): Behavior and config for WhatsApp group message handling (mentionPatterns are shared across surfaces)
- [Groups](/docs/concepts/groups): Group chat behavior across surfaces (WhatsApp/Telegram/Discord/Slack/Signal/iMessage/Microsoft Teams)
- [Markdown formatting](/docs/concepts/markdown-formatting): Markdown formatting pipeline for outbound channels
- [Memory](/docs/concepts/memory): How Reeve memory works (workspace files + automatic memory flush)
- [Messages](/docs/concepts/messages): Message flow, sessions, queueing, and reasoning visibility
- [Model failover](/docs/concepts/model-failover): How Reeve rotates auth profiles and falls back across models
- [Model providers](/docs/concepts/model-providers): Model provider overview with example configs + CLI flows
- [Models](/docs/concepts/models): Model configuration — providers, API keys, model selection, quality tiers, and fallbacks.
- [Multi-Agent Routing](/docs/concepts/multi-agent): Multi-agent routing: isolated agents, channel accounts, and bindings
- [OAuth](/docs/concepts/oauth): OAuth in Reeve: token exchange, storage, CLI sync, and multi-account patterns
- [Pipeline V3 Tools Reference](/docs/concepts/pipeline-v3-tools): Pipeline V3 Tools: CLI tools for running, auditing, and supervising pipelines
- [Pipeline V3 Architecture](/docs/concepts/pipeline-v3): Pipeline V3: Multi-agent orchestration for complex software projects
- [Presence](/docs/concepts/presence): How Reeve presence entries are produced, merged, and displayed
- [Command Queue (2026-01-16)](/docs/concepts/queue): Command queue design that serializes inbound auto-reply runs
- [Retry policy](/docs/concepts/retry): Retry policy for outbound provider calls
- [Session Pruning](/docs/concepts/session-pruning): Session pruning: tool-result trimming to reduce context bloat
- [Session Tools](/docs/concepts/session-tool): Agent session tools for listing sessions, fetching history, and sending cross-session messages
- [Session Management](/docs/concepts/session): Session management rules, keys, and persistence for chats
- [Streaming + chunking](/docs/concepts/streaming): Streaming + chunking behavior (block replies, draft streaming, limits)
- [System Prompt](/docs/concepts/system-prompt): What the Reeve system prompt contains and how it is assembled
- [Timezones](/docs/concepts/timezone): Timezone handling for agents, envelopes, and prompts
- [Token use & costs](/docs/concepts/token-use): How Reeve builds prompt context and reports token usage + costs
- [TypeBox as protocol source of truth](/docs/concepts/typebox): TypeBox schemas as the single source of truth for the gateway protocol
- [Typing indicators](/docs/concepts/typing-indicators): When Reeve shows typing indicators and how to tune them
- [Usage tracking](/docs/concepts/usage-tracking): Usage tracking surfaces and credential requirements
- [API Reference](/docs/config/api-reference): Config system RPC methods for reading, patching, and applying configuration.
- [Config Examples](/docs/config/examples): Common configuration patterns for agents, teams, and organizations.
- [Configuration System](/docs/config): CSS-like config inheritance across universal, org, individual, and workspace layers.
- [Config Layers](/docs/config/layers): Deep dive into the 4-layer config inheritance system — universal, org, individual, workspace.
- [Google Ads](/docs/connectors/google-ads): Connect Google Ads to Reeve for search and display campaign data, keywords, and conversions.
- [Klaviyo](/docs/connectors/klaviyo): Connect Klaviyo to Reeve for email campaign analytics, flows, segments, and SMS data.
- [Meta Ads](/docs/connectors/meta-ads): Connect Facebook and Instagram ad accounts to Reeve for campaign data, ROAS, and creative performance.
- [Connectors Overview](/docs/connectors/overview): What connectors are, how authentication works, and the full list of available integrations.
- [Shopify](/docs/connectors/shopify): Connect your Shopify store to Reeve for product data, order analytics, and customer insights.
- [Slack](/docs/connectors/slack): Connect Slack to Reeve — add the bot to your workspace, configure channels, and let Reeve respond to your team.
- [Architecture](/docs/desktop/architecture): How the Electron app bundles the gateway and Next.js frontend into a native experience.
- [Configuration](/docs/desktop/configuration): Desktop app settings, workspace paths, LLM provider setup, and advanced options.
- [Development](/docs/desktop/development): Building the Reeve Desktop App from source and running in dev mode.
- [Desktop App](/docs/desktop): Native macOS app bundling the gateway and Cockpit for a one-click AI agent experience.
- [Installation](/docs/desktop/installation): Download, install, and configure the Reeve Desktop App.
- [Desktop Overview](/docs/desktop/overview): What the Reeve Desktop App includes, system requirements, and how it works.
- [Desktop Quick Start](/docs/desktop/quick-start): Install the Reeve Desktop App, sign in, and start using your AI business OS in under 5 minutes.
- [Worker Complete](/docs/developers/WORKER-COMPLETE): Developer documentation for the Reeve App Platform.
- [App Review](/docs/developers/app-review): How the Reeve App Store review process works, quality requirements, security standards, and common rejection reasons.
- [Getting Started](/docs/developers/getting-started): Scaffold your first Reeve app with create-reeve-app and see it running inside the Cockpit in under 5 minutes.
- [App Platform](/docs/developers): Build and publish apps on the Reeve App Platform — give every merchant AI-powered tools built exactly for their store.
- [Manifest Reference](/docs/developers/manifest-reference): Complete reference for reeve-manifest.json — all fields, permissions, categories, and validation rules.
- [SDK Reference](/docs/developers/sdk-reference): Full API reference for @reeve/app-sdk — AI completions, cloud storage, data queries, events, navigation, and theming.
- [Ad Management](/docs/features/ads): Manage advertising across Meta and Google Ads — performance tracking, AI creative generation, and competitor analysis.
- [Web Analytics](/docs/features/analytics): GA4 and PostHog integration for traffic, funnels, top pages, daily trends, and geographic data.
- [Brand Intelligence](/docs/features/brand-intelligence): AI-powered brand profiling — analyze websites, extract identity, track competitors, and discover market positioning.
- [Email Marketing](/docs/features/email-marketing): Email and SMS marketing via Klaviyo — campaigns, flows, segments, templates, and analytics.
- [Knowledge Base](/docs/features/knowledge-base): Document ingestion, RAG pipeline, and semantic search for agent-accessible knowledge.
- [Live Streaming](/docs/features/live-streaming): Multi-tenant AI debate streams for live audience engagement.
- [Multi-Brand](/docs/features/multi-brand): Manage multiple products and brands with isolated connections, agents, and analytics.
- [Recruiter](/docs/features/recruiter): AI-powered recruiting — manage positions, score candidates, schedule interviews, and get a daily hiring digest.
- [Revenue Analytics](/docs/features/revenue-analytics): Stripe-powered MRR, LTV, subscription metrics, churn tracking, and revenue trends.
- [Semantic Memory](/docs/features/semantic-memory): Agent memory search with RRF scoring, temporal decay, and configurable merge strategies.
- [Customizable Sidebar](/docs/features/sidebar): Drag-to-reorder, folders, sections, and two-line labels for the Cockpit navigation.
- [Social Media](/docs/features/social-media): Social media management — connected accounts, metrics, growth tracking, top posts, and trend research.
- [Social Tools](/docs/features/social-tools): Reddit digest, iMessage template generator, and social insights for content strategy.
- [Customer Support](/docs/features/support): Connect your helpdesk to Reeve — unified ticket dashboard, escalation management, and support analytics.
- [Web Analytics](/docs/features/web-analytics): GA4 and PostHog integration for traffic, funnels, top pages, and user behavior.
- [Authentication](/docs/gateway/authentication): Model authentication: OAuth, API keys, and Claude Code token reuse
- [Background Exec + Process Tool](/docs/gateway/background-process): Background exec execution and process management
- [Bonjour / mDNS discovery](/docs/gateway/bonjour): Bonjour/mDNS discovery + debugging (Gateway beacons, clients, and common failure modes)
- [Bridge protocol (legacy node transport)](/docs/gateway/bridge-protocol): Bridge protocol (legacy nodes): TCP JSONL, pairing, scoped RPC
- [CLI backends (fallback runtime)](/docs/gateway/cli-backends): CLI backends: text-only fallback via local AI CLIs
- [Configuration Examples](/docs/gateway/configuration-examples): Schema-accurate configuration examples for common Reeve setups
- [Configuration 🔧](/docs/gateway/configuration): All configuration options for ~/.reeve/reeve.json with examples
- [Debugging](/docs/gateway/debugging): Debugging tools: watch mode, raw model streams, and tracing reasoning leakage
- [Discovery & transports](/docs/gateway/discovery): Node discovery and transports (Bonjour, Tailscale, SSH) for finding the gateway
- [Doctor](/docs/gateway/doctor): Doctor command: health checks, config migrations, and repair steps
- [Environment variables](/docs/gateway/environment): Where Reeve loads environment variables and the precedence order
- [Gateway lock](/docs/gateway/gateway-lock): Gateway singleton guard using the WebSocket listener bind
- [Health Checks (CLI)](/docs/gateway/health): Health check steps for channel connectivity
- [Heartbeat (Gateway)](/docs/gateway/heartbeat): Heartbeat polling messages and notification rules
- [Gateway service runbook](/docs/gateway): Runbook for the Gateway service, lifecycle, and operations
- [Local models](/docs/gateway/local-models): Run Reeve on local LLMs (LM Studio, vLLM, LiteLLM, custom OpenAI endpoints)
- [Logging](/docs/gateway/logging): Logging surfaces, file logs, WS log styles, and console formatting
- [Multiple Gateways (same host)](/docs/gateway/multiple-gateways): Run multiple Reeve Gateways on one host (isolation, ports, and profiles)
- [OpenAI Chat Completions (HTTP)](/docs/gateway/openai-http-api): Expose an OpenAI-compatible /v1/chat/completions HTTP endpoint from the Gateway
- [OpenResponses API (HTTP)](/docs/gateway/openresponses-http-api): Expose an OpenResponses-compatible /v1/responses HTTP endpoint from the Gateway
- [Gateway-owned pairing (Option B)](/docs/gateway/pairing): Gateway-owned node pairing (Option B) for iOS and other remote nodes
- [Gateway protocol (WebSocket)](/docs/gateway/protocol): Gateway WebSocket protocol: handshake, frames, versioning
- [Remote access (SSH, tunnels, and tailnets)](/docs/gateway/remote): Remote access using SSH tunnels (Gateway WS) and tailnets
- [Sandbox vs Tool Policy vs Elevated](/docs/gateway/sandbox-vs-tool-policy-vs-elevated): Why a tool is blocked: sandbox runtime, tool allow/deny policy, and elevated exec gates
- [Sandboxing](/docs/gateway/sandboxing): How Reeve sandboxing works: modes, scopes, workspace access, and images
- [Security 🔒](/docs/gateway/security): Security considerations and threat model for running an AI gateway with shell access
- [Tailscale (Gateway cockpit)](/docs/gateway/tailscale): Integrated Tailscale Serve/Funnel for the Gateway cockpit
- [Tools Invoke (HTTP)](/docs/gateway/tools-invoke-http-api): Invoke a single tool directly via the Gateway HTTP endpoint
- [Troubleshooting 🔧](/docs/gateway/troubleshooting): Quick troubleshooting guide for common Reeve failures
- [API Reference](/docs/goals/api-reference): Complete reference for Goals Engine tool actions and RPC methods.
- [Budgets](/docs/goals/budgets): Token and dollar budgets with enforcement gates and human approval checkpoints.
- [Creating Goals](/docs/goals/creating-goals): Create goals via CLI wizard, agent tools, or the dashboard UI.
- [Goals Engine](/docs/goals): Persistent, multi-phase objectives that survive session resets and drive autonomous agent work.
- [Phases](/docs/goals/phases): Multi-phase goals with ordered steps, loop phases, and event-driven activation.
- [Service Loops](/docs/goals/service-loops): Fast, gateway-managed execution loops for intensive goal phases.
- [Triggers](/docs/goals/triggers): Webhooks, thresholds, and events that activate goal phases or advance execution.
- [CLI Setup](/docs/getting-started/cli-setup): Install the Reeve CLI, run the onboarding wizard, and configure your gateway.
- [Cloud Setup](/docs/getting-started/cloud-setup): Create your Reeve Cloud account, connect services, and start using agents without any installation.
- [Core Concepts](/docs/getting-started/concepts): Understand agents, sessions, goals, memory, and tools — the mental model behind Reeve.
- [Quickstart](/docs/getting-started/quickstart): Go from zero to your first AI agent conversation in under 5 minutes.
- [FAQ](/docs/help/faq): Frequently asked questions about Reeve — what it is, pricing, features, data handling, and how to get set up.
- [Help & Support](/docs/help): Get help with Reeve — contact support, find answers, and connect with the community.
- [Troubleshooting](/docs/help/troubleshooting): Fix common Reeve issues — connection problems, auth errors, connector sync failures, and more.
- [SOUL Evil Hook](/docs/hooks/soul-evil): SOUL Evil hook (swap SOUL.md with SOUL_EVIL.md)
- [Ansible Installation](/docs/install/ansible): Automated, hardened Reeve installation with Ansible, Tailscale VPN, and firewall isolation
- [Bun (experimental)](/docs/install/bun): Bun workflow (experimental): installs and gotchas vs pnpm
- [Development channels](/docs/install/development-channels): Stable, beta, and dev channels: semantics, switching, and tagging
- [Docker (optional)](/docs/install/docker): Optional Docker-based setup and onboarding for Reeve
- [Install](/docs/install): Install Reeve (recommended installer, global install, or from source)
- [Installer internals](/docs/install/installer): How the installer scripts work (install.sh + install-cli.sh), flags, and automation
- [Nix Installation](/docs/install/nix): Install Reeve declaratively with Nix
- [Node.js + npm (PATH sanity)](/docs/install/node): Node.js and npm install sanity - versions, PATH, and global installs
- [Deploy on Railway](/docs/install/railway): 
- [Uninstall](/docs/install/uninstall): Uninstall Reeve completely (CLI, service, state, workspace)
- [Updating](/docs/install/updating): Updating Reeve safely (global install or source), plus rollback strategy
- [Mission Control](/docs/mission-control): Monitor parallel sessions, view agent status in a grid, manage goals, and take quick actions — all in real time.
- [Audio / Voice Notes — 2026-01-17](/docs/nodes/audio): How inbound audio/voice notes are downloaded, transcribed, and injected into replies
- [Camera capture (agent)](/docs/nodes/camera): Camera capture (iOS node + macOS app) for agent use: photos (jpg) and short video clips (mp4)
- [Image & Media Support — 2025-12-05](/docs/nodes/images): Image and media handling rules for send, gateway, and agent replies
- [Nodes](/docs/nodes): Nodes: pairing, capabilities, permissions, and CLI helpers for canvas/camera/screen/system
- [Location command (nodes)](/docs/nodes/location-command): Location command for nodes (location.get), permission modes, and background behavior
- [Media Understanding (Inbound) — 2026-01-17](/docs/nodes/media-understanding): Inbound image/audio/video understanding (optional) with provider + CLI fallbacks
- [Talk Mode](/docs/nodes/talk): Talk mode: continuous speech conversations with ElevenLabs TTS
- [Voice Wake (Global Wake Words)](/docs/nodes/voicewake): Global voice wake words (Gateway-owned) and how they sync across nodes
- [Code Over Prompts](/docs/philosophy/code-over-prompts): 
- [Android App (Node)](/docs/platforms/android): Android app (node): connection runbook + Canvas/Chat/Camera
- [exe.dev](/docs/platforms/exe-dev): Run Reeve Gateway on exe.dev (VM + HTTPS proxy) for remote access
- [Fly.io](/docs/platforms/fly): Deploy Reeve on Fly.io
- [Reeve on Hetzner (Docker, Production VPS Guide)](/docs/platforms/hetzner): Run Reeve Gateway 24/7 on a cheap Hetzner VPS (Docker) with durable state and baked-in binaries
- [Platforms](/docs/platforms): Platform support overview (Gateway + companion apps)
- [iOS App (Node)](/docs/platforms/ios): iOS node app: connect to the Gateway, pairing, canvas, and troubleshooting
- [Linux App](/docs/platforms/linux): Linux support + companion app status
- [Reeve on macOS VMs (Sandboxing)](/docs/platforms/macos-vm): Run Reeve in a sandboxed macOS VM (local or hosted) when you need isolation or iMessage
- [Reeve macOS Companion (menu bar + gateway broker)](/docs/platforms/macos): Reeve macOS companion app (menu bar + gateway broker)
- [Windows (WSL2)](/docs/platforms/windows): Windows (WSL2) support + companion app status
- [Plugin agent tools](/docs/plugins/agent-tools): Write agent tools in a plugin (schemas, optional tools, allowlists)
- [Coordinator Enforcer Plugin (Legacy)](/docs/plugins/coordinator-enforcer): Coordinator Enforcer: Automatically block direct work tools in main sessions (superseded by role-enforcer)
- [Plugin manifest (reeve.plugin.json)](/docs/plugins/manifest): Plugin manifest + JSON schema requirements (strict config validation)
- [Plugins (Extensions)](/docs/plugins/overview): Reeve plugins/extensions: discovery, config, and safety
- [Role Enforcer Plugin](/docs/plugins/role-enforcer): Role Enforcer: Unified three-tier enforcement for Coordinator → Manager → Worker
- [Voice Call (plugin)](/docs/plugins/voice-call): Voice Call plugin: outbound + inbound calls via Twilio/Telnyx/Plivo (plugin install + config + CLI)
- [Zalo Personal (plugin)](/docs/plugins/zalouser): Zalo Personal plugin: QR login + messaging via zca-cli (plugin install + channel config + CLI + tool)
- [Anthropic (Claude)](/docs/providers/anthropic): Use Anthropic Claude via API keys or Claude Code CLI auth in Reeve
- [Amazon Bedrock](/docs/providers/bedrock): Use Amazon Bedrock (Converse API) models with Reeve
- [Deepgram (Audio Transcription)](/docs/providers/deepgram): Deepgram transcription for inbound voice notes
- [Github Copilot](/docs/providers/github-copilot): Sign in to GitHub Copilot from Reeve using the device flow
- [GLM models](/docs/providers/glm): GLM model family overview + how to use it in Reeve
- [Model Providers](/docs/providers): Model providers (LLMs) supported by Reeve
- [MiniMax](/docs/providers/minimax): Use MiniMax M2.1 in Reeve
- [Moonshot AI (Kimi)](/docs/providers/moonshot): Configure Moonshot K2 vs Kimi Code (separate providers + keys)
- [Ollama](/docs/providers/ollama): Run Reeve with Ollama (local LLM runtime)
- [OpenAI](/docs/providers/openai): Use OpenAI via API keys or Codex subscription in Reeve
- [OpenCode Zen](/docs/providers/opencode): Use OpenCode Zen (curated models) with Reeve
- [OpenRouter](/docs/providers/openrouter): Use OpenRouter's unified API to access many models in Reeve
- [Qwen](/docs/providers/qwen): Use Qwen OAuth (free tier) in Reeve
- [Synthetic](/docs/providers/synthetic): Use Synthetic's Anthropic-compatible API in Reeve
- [Venice AI (Venius highlight)](/docs/providers/venice): Use Venice AI privacy-focused models in Reeve
- [Vercel AI Gateway](/docs/providers/vercel-ai-gateway): Vercel AI Gateway setup (auth + model selection)
- [Z.AI](/docs/providers/zai): Use Z.AI (GLM models) with Reeve
- [AGENTS.md — Reeve Personal Assistant (default)](/docs/reference/AGENTS.default): Default Reeve agent instructions and skills roster for the personal assistant setup
- [Release Checklist (npm + macOS)](/docs/reference/RELEASING): Step-by-step release checklist for npm + macOS app
- [API usage & costs](/docs/reference/api-usage-costs): Audit what can spend money, which keys are used, and how to view usage
- [Device model database (friendly names)](/docs/reference/device-models): How Reeve vendors Apple device model identifiers for friendly names in the macOS app.
- [Features Reference](/docs/reference/features): Comprehensive feature list and subsystem overview
- [RPC adapters](/docs/reference/rpc): RPC adapters for external CLIs (signal-cli, imsg) and gateway patterns
- [Scripts](/docs/reference/scripts): Repository scripts: purpose, scope, and safety notes
- [Session Management & Compaction (Deep Dive)](/docs/reference/session-management-compaction): Deep dive: session store + transcripts, lifecycle, and (auto)compaction internals
- [Tests](/docs/reference/test): How to run tests locally (vitest) and when to use force/coverage modes
- [Testing](/docs/reference/testing): Testing kit: unit/e2e/live suites, Docker runners, and what each test covers
- [Transcript Hygiene (Provider Fixups)](/docs/reference/transcript-hygiene): Reference: provider-specific transcript sanitization and repair rules
- [Authentication](/docs/services/authentication): Session-based auth with Clerk integration, magic links, and service-to-service tokens.
- [Connectors API](/docs/services/connectors-api): OAuth flows for Meta, Google, TikTok, Shopify, and API key management for Stripe, PostHog, Klaviyo.
- [Credits & Billing](/docs/services/credits-billing): Credit system implementation, Stripe integration, and tier-based usage metering.
- [Services API](/docs/services): Python FastAPI backend providing authentication, connectors, billing, and analytics.
- [Work Pipelines](/docs/services/work-pipelines): Background job processing for analytics aggregation, connector sync, and report generation.
- [Getting Started](/docs/start/getting-started): Three ways to start using Reeve — Desktop App, web, or CLI self-hosted. Pick your path and go.
- [Onboarding (macOS app)](/docs/start/onboarding): First-run onboarding flow for Reeve (macOS app)
- [Pairing](/docs/start/pairing): Pairing overview: approve who can DM you + which nodes can join
- [Quick Start](/docs/start/quick-start): Get up and running with Reeve in 5 minutes — download the app, sign in, and start using your AI business OS.
- [Setup](/docs/start/setup): Setup guide: keep your Reeve setup tailored while staying up-to-date
- [Showcase](/docs/start/showcase): Real-world Reeve projects from the community
- [Onboarding Wizard (CLI)](/docs/start/wizard): CLI onboarding wizard: guided setup for gateway, workspace, channels, and skills
- [reeve agent (direct agent runs)](/docs/tools/agent-send): Direct `reeve agent` CLI runs (with optional delivery)
- [apply_patch tool](/docs/tools/apply-patch): Apply multi-file patches with the apply_patch tool
- [Browser Troubleshooting (Linux)](/docs/tools/browser-linux-troubleshooting): Fix Chrome/Brave/Edge/Chromium CDP startup issues for Reeve browser control on Linux
- [Browser login + X/Twitter posting](/docs/tools/browser-login): Manual logins for browser automation + X/Twitter posting
- [Browser (reeve-managed)](/docs/tools/browser): Integrated browser control server + action commands
- [Chrome extension (browser relay)](/docs/tools/chrome-extension): Chrome extension: let Reeve drive your existing Chrome tab
- [ReeveHub](/docs/tools/clawdhub): ReeveHub guide: public skills registry + CLI workflows
- [Creating Custom Skills 🛠](/docs/tools/creating-skills): 
- [Elevated Mode (/elevated directives)](/docs/tools/elevated): Elevated exec mode and /elevated directives
- [Exec approvals](/docs/tools/exec-approvals): Exec approvals, allowlists, and sandbox escape prompts
- [Exec tool](/docs/tools/exec): Exec tool usage, stdin modes, and TTY support
- [Firecrawl](/docs/tools/firecrawl): Firecrawl fallback for web_fetch (anti-bot + cached extraction)
- [Tools (Reeve)](/docs/tools): Agent tool surface for Reeve (browser, canvas, nodes, message, cron) replacing legacy `reeve-*` skills
- [LLM Task](/docs/tools/llm-task): JSON-only LLM tasks for workflows (optional plugin tool)
- [Lobster](/docs/tools/lobster): Typed workflow runtime for Reeve — composable pipelines with approval gates.
- [Tool-loop detection](/docs/tools/loop-detection): Configure optional guardrails for preventing repetitive or stalled tool-call loops
- [Multi-Agent Sandbox & Tools](/docs/tools/multi-agent-sandbox-tools): Per-agent sandbox + tool restrictions, precedence, and examples
- [Reaction tooling](/docs/tools/reactions): Reaction semantics shared across channels
- [Skills Config](/docs/tools/skills-config): Skills config schema and examples
- [Skills (Reeve)](/docs/tools/skills): Skills: managed vs workspace, gating rules, and config/env wiring
- [Slash commands](/docs/tools/slash-commands): Slash commands: text vs native, config, and supported commands
- [Sub-agents](/docs/tools/subagents): Sub-agents: spawning isolated agent runs that announce results back to the requester chat
- [Thinking Levels (/think directives)](/docs/tools/thinking): Directive syntax for /think + /verbose and how they affect model reasoning
- [Web tools](/docs/tools/web): Web search + fetch tools (Brave Search API, Perplexity direct/OpenRouter)
- [Cockpit (Control UI)](/docs/web/cockpit): Gateway cockpit (Control UI) access and auth
- [Control UI (browser)](/docs/web/control-ui): Browser-based control UI for the Gateway (chat, nodes, config)
- [Cockpit (Control UI)](/docs/web/dashboard): Gateway cockpit (Control UI) access and auth
- [Web (Gateway)](/docs/web): Gateway web surfaces: Control UI, bind modes, and security
- [TUI (Terminal UI)](/docs/web/tui): Terminal UI (TUI): connect to the Gateway from any machine
- [WebChat (Gateway WebSocket UI)](/docs/web/webchat): Loopback WebChat static host and Gateway WS usage for chat UI
- [Custom AI Agent](/docs/developers/tutorials/agent-app): Build a custom AI agent with a tailored personality, Shopify data access, and publish it to the Reeve Marketplace.
- [AI Email Campaign Builder](/docs/developers/tutorials/email-campaign-builder): Build an AI-powered email campaign builder that generates copy, pulls audience data, and saves campaigns to cloud storage.
- [Shopify Sales Dashboard](/docs/developers/tutorials/shopify-dashboard): Build a live Shopify sales dashboard with revenue charts and order tables — step by step in 15 minutes.
- [Gateway on macOS (external launchd)](/docs/platforms/mac/bundled-gateway): Gateway runtime on macOS (external launchd service)
- [Canvas (macOS app)](/docs/platforms/mac/canvas): Agent-controlled Canvas panel embedded via WKWebView + custom URL scheme
- [Gateway lifecycle on macOS](/docs/platforms/mac/child-process): Gateway lifecycle on macOS (launchd)
- [macOS Developer Setup](/docs/platforms/mac/dev-setup): Setup guide for developers working on the Reeve macOS app
- [Health Checks on macOS](/docs/platforms/mac/health): How the macOS app reports gateway/Baileys health states
- [Menu Bar Icon States](/docs/platforms/mac/icon): Menu bar icon states and animations for Reeve on macOS
- [Logging (macOS)](/docs/platforms/mac/logging): Reeve logging: rolling diagnostics file log + unified log privacy flags
- [Menu Bar Status Logic](/docs/platforms/mac/menu-bar): Menu bar status logic and what is surfaced to users
- [Peekaboo Bridge (macOS UI automation)](/docs/platforms/mac/peekaboo): PeekabooBridge integration for macOS UI automation
- [macOS permissions (TCC)](/docs/platforms/mac/permissions): macOS permission persistence (TCC) and signing requirements
- [Reeve macOS release (Sparkle)](/docs/platforms/mac/release): Reeve macOS release checklist (Sparkle feed, packaging, signing)
- [Remote Reeve (macOS ⇄ remote host)](/docs/platforms/mac/remote): macOS app flow for controlling a remote Reeve gateway over SSH
- [mac signing (debug builds)](/docs/platforms/mac/signing): Signing steps for macOS debug builds generated by packaging scripts
- [Skills (macOS)](/docs/platforms/mac/skills): macOS Skills settings UI and gateway-backed status
- [Voice Overlay Lifecycle (macOS)](/docs/platforms/mac/voice-overlay): Voice overlay lifecycle when wake-word and push-to-talk overlap
- [Voice Wake & Push-to-Talk](/docs/platforms/mac/voicewake): Voice wake and push-to-talk modes plus routing details in the mac app
- [WebChat (macOS app)](/docs/platforms/mac/webchat): How the mac app embeds the gateway WebChat and how to debug it
- [Reeve macOS IPC architecture](/docs/platforms/mac/xpc): macOS IPC architecture for Reeve app, gateway node transport, and PeekabooBridge
- [AGENTS.md - Reeve Workspace](/docs/reference/templates/AGENTS.dev): Dev agent AGENTS.md (C-3PO)
- [AGENTS.md - Your Workspace](/docs/reference/templates/AGENTS): Workspace template for AGENTS.md
- [BOOT.md](/docs/reference/templates/BOOT): Workspace template for BOOT.md
- [BOOTSTRAP.md - Hello, World](/docs/reference/templates/BOOTSTRAP): First-run ritual for new agents
- [HEARTBEAT.md](/docs/reference/templates/HEARTBEAT): Workspace template for HEARTBEAT.md
- [IDENTITY.md - Agent Identity](/docs/reference/templates/IDENTITY.dev): Dev agent identity (C-3PO)
- [IDENTITY.md - Who Am I?](/docs/reference/templates/IDENTITY): Agent identity record
- [SOUL.md - The Soul of C-3PO](/docs/reference/templates/SOUL.dev): Dev agent soul (C-3PO)
- [SOUL.md — Who You Are](/docs/reference/templates/SOUL): Workspace template for SOUL.md
- [TOOLS.md - User Tool Notes (editable)](/docs/reference/templates/TOOLS.dev): Dev agent tools notes (C-3PO)
- [TOOLS.md - Local Notes](/docs/reference/templates/TOOLS): Workspace template for TOOLS.md
- [USER.md - User Profile](/docs/reference/templates/USER.dev): Dev agent user profile (C-3PO)
- [USER.md - About Your Human](/docs/reference/templates/USER): User profile record