Getting Started

Choose how you want to use Reeve. Most people start with the Desktop App or web — the CLI path is for power users and self-hosters who want to run their own instance.

Desktop App

The fastest path. Download, install, and you're running in under 5 minutes.

1. Download

Go to meetreeve.com and download the Desktop App:

• macOS Apple Silicon — M1/M2/M3/M4 Macs (2020 or later)
• macOS Intel — Older Macs

Windows and Linux are coming soon.

2. Install

Open the .dmg and drag Reeve to your Applications folder. Launch from Spotlight or Applications.

3. Sign In

A browser window opens automatically. Sign in with Google, a magic link, or email + password. The app receives your session and you're connected.

4. Connect a Data Source

In the Cockpit, go to Connectors and add a platform. Good first choices:

• Shopify — Revenue, orders, products
• Meta Ads — Ad spend and ROAS
• Klaviyo — Email campaign performance

Click Connect, authorize, and data flows into your dashboard.

5. Ask Reeve Something

Go to Chat and try:

"How did revenue look this week?" "What are my top-performing ads?" "Summarize our email campaign performance."

For a more detailed walkthrough, see the Desktop Quick Start.

Web App

No download required. Sign in from any browser.

1. Go to app.meetreeve.com
2. Create an account or sign in
3. Connect your platforms via Connectors
4. Start using the Dashboard and Chat

The web app has the same features as the Desktop App. Use whichever is more convenient.

CLI / Self-Hosted

For users who want to run Reeve on their own hardware — VPS, Mac mini, Raspberry Pi, or cloud server.

Prerequisites

• Node.js 22+ — nodejs.org
• macOS or Linux (Windows via WSL2)

Install

curl -fsSL https://reeve.com/install.sh | bash

Or via npm:

npm install -g reeve@latest

Run Onboarding

reeve onboard --install-daemon

The wizard configures:

• Model auth — Anthropic, OpenAI, or local models
• Gateway settings — Port, bind address, auth token
• Chat channels — WhatsApp, Telegram, Discord, Slack, and more
• Background service — launchd on macOS, systemd on Linux

Verify

reeve status    # Quick health check
reeve health    # Deep gateway probe

Open the Cockpit

reeve cockpit

This opens the web Cockpit in your browser with the correct auth token.

Connect Messaging Channels

Set up the channels you want Reeve to respond on:

• WhatsApp — Scan a QR code
• Telegram — Paste your bot token
• Discord — Paste your bot token
• Slack — Socket mode with app + bot tokens

Run a Quick Test

reeve message send --target "+15555550123" --message "Hello from Reeve"

What's Next?

Need help? See Troubleshooting or ask on Discord.