Quick Start

Prerequisites

• Bun 1.2+
• Wrangler 4+
• A Cloudflare account (Workers Paid plan)
• A GitHub personal access token with repo scope

Install

Clone the repository and install dependencies:

git clone https://github.com/danielbodnar/auto-sre-agents.git
cd auto-sre-agents
bun install

Configure Secrets

Copy the example environment file and fill in your values:

cp .dev.vars.example .dev.vars

Edit .dev.vars:

GITHUB_TOKEN=ghp_your_token_here
ANTHROPIC_API_KEY=sk-ant-your_key_here
CLOUDFLARE_API_TOKEN=your_cf_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

Generate Types

Generate the TypeScript types from your Wrangler configuration:

bunx wrangler@latest types

Initialize the Database

Create the D1 tables locally:

bun run db:migrate

Start Development

bun run dev

This starts a local Wrangler development server. The Orchestrator API is available at http://localhost:8787.

Register a Service

Tell Sentinel which Worker to monitor:

curl -X PUT http://localhost:8787/api/config/services/my-worker \
  -H "Content-Type: application/json" \
  -d '{
    "serviceName": "my-worker",
    "repoUrl": "https://github.com/your-org/my-worker",
    "repoBranch": "main",
    "enabled": true
  }'

Verify

Check the health endpoint:

curl http://localhost:8787/api/health

List monitored services:

curl http://localhost:8787/api/config/services

Run Tests

bun test

Next Steps

• Configuration — tune polling intervals, error filters, and LLM models
• Architecture — understand how the agents communicate
• Deployment — deploy to Cloudflare Workers