BeeDocsby BeeGreat
Run locally
Developer guide

Run BeeGreat locally

Set up the Bun workspace, Convex deployment, mobile app, and Bee agent in dependency order.

Requirements

First-time setup

Install the workspace

From the repository root, run bun install.

Create local environment files

Copy apps/mobile/.env.example to apps/mobile/.env and packages/agent/.env.example to packages/agent/.dev.vars.

Configure Convex

Run bun run backend. Sign in when prompted and select or create the development deployment.

Fill the client values

Set the Clerk publishable key, Convex URL, agent URL, and optional Sentry values in apps/mobile/.env.

Fill the agent values

Set Convex, Clerk issuer, ElevenLabs, model-provider, and credential-broker values in packages/agent/.dev.vars.

Keep secrets server-side

Never put provider keys or the credential-broker secret in an EXPO_PUBLIC_* variable.

Run the mobile stack

bun run mobile

This starts Convex, the Bee agent, and the Expo iOS app together. Bee’s local worker listens on http://localhost:3583.

Run one service

bun run backend   # Convex
bun run agent     # Flue worker
bun run web       # TanStack shell
bun run docs      # BeeDocs

Use separate terminals only when you need to isolate a service.