Cudgel

Cudgel is a personal AI work agent that turns developer notifications into actionable tasks, runs focused workflows like review and codegen, and keeps an auditable record of what it decided and did.

Status: product and architecture planning. Implementation has not started yet.

The system is split into:

• Cloud control plane: receives GitHub, Linear, and other webhooks; normalizes events; triages tasks; stores approvals, runs, and memory.
• Local worker: runs on the user's machine; accesses local repositories; invokes Codex, Claude Code, or other agent adapters; runs tests; generates artifacts.

MVP

The first version focuses on one loop:

1. Receive GitHub webhook events.
2. Convert relevant events into tasks.
3. Route review tasks to a local worker.
4. Generate a local PR review artifact.
5. Ask for approval before posting back to GitHub.

Docs

• Product Brief
• Architecture
• Data Model