Quickstart

Get Beevibe running on your machine. One Docker command brings up the stack. Then you mint a user token and install the daemon that spawns your CLI.

Prerequisites

Docker (with Compose).
Node 20+ and pnpm — used once to mint a user token.
An Anthropic key and an OpenAI key. Beevibe uses Claude for the agents and OpenAI for embeddings.
Claude Code CLI installed on the machine where you want sessions to run (this is where the daemon spawns it).

Bring up the stack

Clone the repo and start everything with one command. The compose file builds Postgres, the API, the scheduler, and the web dashboard.

git clone https://github.com/beevibe-ai/beevibe.git
cd beevibe

ANTHROPIC_API_KEY=sk-ant-… \
OPENAI_API_KEY=sk-…       \
docker compose -f docker-compose.quickstart.yml up -d --build

bash

When it's up, open http://localhost:3030. The API listens on port 3000; the web dashboard on 3030.

Mint a user token

The daemon needs a bv_u_ user token to register itself with the API. Mint one with pnpm:

pnpm install
pnpm provision-user

bash

The command prints a token that starts with bv_u_. Copy it.

Install the daemon

The daemon is a small local process that lives on your machine. Its job is to take sessions claimed for you and spawn the Claude Code CLI to run them. It doesn't proxy your CLI — it just launches it with the right environment.

brew install beevibe-ai/tap/beevibe-daemon

beevibe-daemon setup \
  --api http://localhost:3000 \
  --user-token bv_u_…

beevibe-daemon start

bash

setup scans your PATH for known CLIs (claude, etc.), registers your machine with the API, and writes ~/.beevibe/config.json with a daemon-specific token. start opens a WebSocket to the API and begins claiming sessions.

Verify

Open http://localhost:3030/runtimes in the dashboard. You should see your machine listed as a runtime, with the CLI you have installed (usually claude) and a green status.

If you don't see your machine, check that beevibe-daemon start is still running and that the API URL it was set up with is reachable.

Shut down

When you're done:

docker compose -f docker-compose.quickstart.yml down -v

bash

The -v drops the Postgres volume too. Skip it if you want to keep the data for next time.

Prefer Railway?

The same stack runs on Railway from a template. Each user still installs beevibe-daemon locally — the hosted API doesn't spawn CLIs. See the deploy button on the landing page.

What's next

Concepts — the vocabulary you'll see in the dashboard.
Architecture — what the five processes do and how a session runs end to end.
GitHub — issues, source, releases.

Overview

Concepts