Features Reference

This document provides a comprehensive overview of Reeve's features and subsystems.

Core Platform

• Gateway WS control plane with sessions, presence, config, cron, webhooks, Control UI, and Canvas host.
• CLI surface: gateway, agent, send, wizard, and doctor.
• Pi agent runtime in RPC mode with tool streaming and block streaming.
• Session model: main for direct chats, group isolation, activation modes, queue modes, reply-back. Group rules: Groups.
• Media pipeline: images/audio/video, transcription hooks, size caps, temp file lifecycle. Audio details: Audio.

Channels

• Channels overview: WhatsApp (Baileys), Telegram (grammY), Slack (Bolt), Discord (discord.js), Google Chat (Chat API), Signal (signal-cli), iMessage (imsg), BlueBubbles (extension), Microsoft Teams (extension), Matrix (extension), Zalo (extension), Zalo Personal (extension), WebChat.
• Group routing: mention gating, reply tags, per-channel chunking and routing.

Apps + Nodes

• macOS app: menu bar control plane, Voice Wake/PTT, Talk Mode overlay, WebChat, debug tools, remote gateway control.
• iOS node: Canvas, Voice Wake, Talk Mode, camera, screen recording, Bonjour pairing.
• Android node: Canvas, Talk Mode, camera, screen recording, optional SMS.
• macOS node mode: system.run/notify + canvas/camera exposure.

Tools + Automation

• Browser control: dedicated reeve Chrome/Chromium, snapshots, actions, uploads, profiles.
• Canvas: A2UI push/reset, eval, snapshot.
• Nodes: camera snap/clip, screen record, location.get, notifications.
• Cron + wakeups; webhooks; Gmail Pub/Sub.
• Skills platform: bundled, managed, and workspace skills with install gating + UI.

Runtime + Safety

• Channel routing, retry policy, and streaming/chunking.
• Presence, typing indicators, and usage tracking.
• Models, model failover, and session pruning.
• Security and troubleshooting.

Ops + Packaging

• Cockpit UI + WebChat served directly from the Gateway.
• Tailscale Serve/Funnel or SSH tunnels with token/password auth.
• Nix mode for declarative config; Docker-based installs.
• Doctor migrations, logging.

Key Subsystems

• Gateway WebSocket network — single WS control plane for clients, tools, and events.
• Tailscale exposure — Serve/Funnel for the Gateway dashboard + WS.
• Browser control — reeve‑managed Chrome/Chromium with CDP control.
• Canvas + A2UI — agent‑driven visual workspace.
• Voice Wake + Talk Mode — always‑on speech and continuous conversation.
• Nodes — Canvas, camera snap/clip, screen record, location.get, notifications.

Agent to Agent (sessions_* tools)

• Use these to coordinate work across sessions without jumping between chat surfaces.
• sessions_list — discover active sessions (agents) and their metadata.
• sessions_history — fetch transcript logs for a session.
• sessions_send — message another session; optional reply‑back ping‑pong + announce step.

Details: Session tools

Skills Registry (ReeveHub)

ReeveHub is a minimal skill registry. With ReeveHub enabled, the agent can search for skills automatically and pull in new ones as needed.

ReeveHub

Chat Commands

Send these in WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat (group commands are owner-only):

• /status — compact session status (model + tokens, cost when available)
• /new or /reset — reset the session
• /compact — compact session context (summary)
• /think <level> — off|minimal|low|medium|high|xhigh
• /verbose on|off
• /usage off|tokens|full — per-response usage footer
• /restart — restart the gateway (owner-only in groups)
• /activation mention|always — group activation toggle (groups only)

Models

Subscriptions (OAuth):

• Anthropic (Claude Pro/Max)
• OpenAI (ChatGPT/Codex)

Model note: while any model is supported, Anthropic Pro/Max + Opus 4.5 is recommended for long-context strength and better prompt-injection resistance.

• Models config + CLI: Models
• Auth profile rotation (OAuth vs API keys) + fallbacks: Model failover

Development Channels

• stable: tagged releases (vYYYY.M.D or vYYYY.M.D-<patch>), npm dist-tag latest.
• beta: prerelease tags (vYYYY.M.D-beta.N), npm dist-tag beta.
• dev: moving head of main, npm dist-tag dev (when published).

Switch channels: reeve update --channel stable|beta|dev. Details: Development channels.

Security Model

• Default: tools run on the host for the main session, so the agent has full access when it's just you.
• Group/channel safety: set agents.defaults.sandbox.mode: "non-main" to run non‑main sessions inside per‑session Docker sandboxes.
• Sandbox defaults: allowlist bash, process, read, write, edit, sessions_list, sessions_history, sessions_send, sessions_spawn; denylist browser, canvas, nodes, cron, discord, gateway.

Details: Security guide · Docker + sandboxing · Sandbox config

Remote Gateway

Run the Gateway on a Linux instance. Clients (macOS app, CLI, WebChat) connect over Tailscale Serve/Funnel or SSH tunnels, and you can pair device nodes (macOS/iOS/Android) to execute device-local actions.

• Gateway host runs the exec tool and channel connections by default.
• Device nodes run device-local actions (system.run, camera, screen recording, notifications) via node.invoke.

Details: Remote access · Nodes · Security

Tailscale Access

Reeve can auto-configure Tailscale Serve (tailnet-only) or Funnel (public):

• off: no Tailscale automation (default).
• serve: tailnet-only HTTPS via tailscale serve.
• funnel: public HTTPS via tailscale funnel (requires password auth).

Details: Tailscale guide

macOS Permissions via Gateway Protocol

The macOS app can run in node mode and advertise capabilities over the Gateway WebSocket:

• system.run runs a local command and returns stdout/stderr/exit code.
• system.notify posts a user notification.
• canvas.*, camera.*, screen.record, and location.get follow TCC permission status.

Details: Nodes · macOS app · Gateway protocol