-
Clone the repo and install dependencies:
git clone https://github.com/getsentry/outpost.git cd outpost pnpm install -
Copy the environment template and fill in your credentials:
cp apps/server/.env.example apps/server/.dev.vars
-
Run D1 migrations locally:
pnpm -F @jared/server db:migrate:dev
-
Start the dev server:
pnpm dev
apps/server/— the main Cloudflare Worker + React dashboardapps/server/src/agents/— Flue'use agent'modules (Jared + subagents)apps/server/container/— thin Sandbox image (Phase 2) + Phase 1 Flue appapps/server/src/routes/— API route handlersapps/server/src/client/— React SPA (dashboard UI)apps/server/src/lib/— shared business logicdocs/— Flue migration notes (FLUE_PARITY.md,LORE_GATEWAY.md)packages/— shared packages (utils, validations)
- TypeScript — strict mode, no
anyunless necessary - Biome — linting and formatting (
pnpm format) - Imports — use
@/path alias forapps/server/src/
- Create a new file in
apps/server/src/routes/webhooks/(e.g.gitlab.ts) - Implement signature verification and payload parsing
- Use
ensureSandboxReady()anddispatchPrompt()from@/lib/containers/dispatchfor container management - Mount the handler in
apps/server/src/routes/webhooks/index.ts - Add any new environment variables to
apps/server/src/types/env/base.ts
Agent skills live in apps/server/container/skills/ — this is the single source
of truth. Each skill is a directory with:
SKILL.md— instructions the agent follows when the skill is loadedreferences/— optional supporting files theSKILL.mdlinks toSPEC.md— optional authoring-only design notes (not shipped to the sandbox)
The runtime tree apps/server/container/.agents/skills/ (baked into the image
and discovered by Flue) is generated from skills/ — it mirrors every file
except SPEC.md. After editing a skill, regenerate and commit the result:
pnpm -F @jared/server sync:skillsCI fails if .agents/skills/ is out of date with skills/, so never hand-edit
the generated tree.
- D1 (SQLite) via Drizzle ORM
- Schema:
apps/server/src/db/schema.ts - Generate migrations:
pnpm -F @jared/server db:generate - Apply locally:
pnpm -F @jared/server db:migrate:dev - Apply production:
pnpm -F @jared/server db:migrate:prod
pnpm deployThis runs turbo deploy which builds the Worker, builds the client, pushes the container image, and deploys to Cloudflare.
- Webhook handlers go in
src/routes/webhooks/<provider>.ts - Container/sandbox logic goes in
src/lib/containers/ - Provider-specific logic (auth, API clients) goes in
src/lib/<provider>/ - All container communication uses
sandbox.exec()— there is no direct network path from the Worker to the container - Session data syncs from the container to D1 when the dashboard detail page is accessed (auto-sync)