errandd

A self-hosted daemon that puts your coding agent on watch — listening to your dev and prod environment and acting on what it sees.

Errandd runs a coding-agent CLI — Claude Code by default, or Pi — as a background daemon wired into the systems your team already uses. It listens for events (GitHub pull requests, Sentry errors, Datadog alerts, Linear issues) and runs scheduled routines (morning ticket triage, nightly sweeps, recurring checks). Each event or tick is matched against your routines — plain markdown files, version-controlled — and handed to the agent to investigate, triage, or fix. A web dashboard and Telegram/Discord/Slack bridges let you watch and steer it in real time.

It's built on the coding-agent subscription you already pay for — no per-call API bill, no cloud to trust with your source. (Formerly clawdcode.)

How it works

GitHub · Sentry · Datadog · Linear ─┐
                                     ├─► match routines ─► enqueue job ─► agent (Claude / Pi) ─► investigate · triage · act
        cron schedule ──────────────┘

1. An event arrives — a signed webhook from GitHub/Sentry/Datadog/Linear, or a cron tick.
2. It's matched against every routine's on: triggers.
3. Matches become durable jobs on a queue (they survive restarts).
4. The agent runs the routine in an isolated session, using the tools your coding-agent CLI already has — reading the diff, querying logs, posting a review, opening a ticket.
5. You watch and steer from the dashboard or a chat bridge, and every delivery is recorded so nothing is silently dropped.

Event sources

Errandd exposes one signed webhook per provider. Each incoming delivery is verified, recorded, and matched against your routines' triggers.

Source	Endpoint	Auth	Triggers
GitHub	POST /api/webhooks/github	HMAC X-Hub-Signature-256 — ERRANDD_GITHUB_WEBHOOK_SECRET	prs, pr, comments, reviews, checks, issues
Sentry	POST /api/webhooks/sentry	HMAC Sentry-Hook-Signature — ERRANDD_SENTRY_CLIENT_SECRET	sentry
Datadog	POST /api/webhooks/datadog	X-Errandd-Token / ?token= — ERRANDD_DATADOG_WEBHOOK_SECRET	datadog
Linear	POST /api/webhooks/linear	HMAC Linear-Signature — ERRANDD_LINEAR_WEBHOOK_SECRET	linear

The GitHub receiver understands the real payloads — it parses pull requests, review comments, checks, and issues, skips its own bot activity, honors a claw:ignore label, and drops CI noise before it ever reaches the agent. Sentry keeps a first-seen ledger so you're triaged once per issue, not once per event. Datadog ships a recommended payload template you paste into your monitor.

Prefer to push events yourself? POST /api/inject runs a one-shot agent message from any script or CI step (bearer/web token, or a static settings.apiToken).

Routines as code

A routine is a markdown file describing a task, with an on: block declaring what triggers it. Point Errandd at a git repo (jobsRepo.url / ERRANDD_JOBSREPO_URL) and every top-level .md file becomes a routine — cloned on start, pulled on an interval. Your automation lives in version control, reviewed like any other code.

---
description: Review new and updated pull requests
on:
  - prs: true
---

Review the pull request diff for bugs, missing tests, and unclear code.
Leave inline review comments where you can be specific, then post a short
summary. Approve only if it's clearly safe.

Triggers combine freely — an event, a schedule, or both:

---
description: Triage new Sentry issues, and sweep the backlog each morning
on:
  - sentry: true
  - schedule: "0 9 * * 1-5"
---

For each Sentry issue, find the offending code, assess severity and likely
cause, and open a Linear ticket with a proposed fix when it's actionable.