Get started
Stop giving the same correction twice.
Birdie turns real feedback into reviewed guidance that appears when similar work returns. Everyone can contribute and everyone can learn.
How Birdie works
- Notice real corrections. A connected work tool captures meaningful before/after feedback without asking someone to author a playbook.
- Review three simple fields. Edit what was initially wrong, what to do instead, and why it matters.
- Bring guidance back. Check approved lessons against current work and stay silent when the match is weak.
Get started
Deploy
Run one persistent Birdie service. Build the Docker image on a host with a persistent volume mounted at /data. Set a public HTTPS origin, an auth secret, and bootstrap admin credentials.
BETTER_AUTH_SECRET=at-least-32-characters
BIRDIE_BASE_URL=https://birdie.example.com
BIRDIE_ADMIN_EMAIL=admin@example.com
BIRDIE_ADMIN_PASSWORD=at-least-12-characters
DB_PATH=/data/birdie.dbFirst start
Birdie creates the configured admin only when that email does not exist. Future restarts do not reset its password. Sign in and create the remaining users from the Users tab.
Get started
Connect MCP
Point clients at the hosted endpoint.
https://birdie.example.com/mcpThe client discovers OAuth metadata, opens Birdie's sign-in and consent screens, then receives a token bound to the MCP resource. No local database or stdio bridge is needed.
Claude plugin
The repository's plugin retains the proactive Birdie skill. It no longer launches a local server; configure the team's remote MCP URL separately.
Guides
Workflow
Real correction, simple lesson, human gate.
Capture
The connected agent records genuine original and corrected work as source evidence.
Draft
The agent proposes what was initially wrong, what to do instead, and why it matters. Birdie verifies the quote.
Review
Any permitted teammate can edit all three fields, reject, merge, or explicitly promote the lesson.
Guide
Assistants check promoted lessons during similar work, explain direct matches, and remain silent otherwise.
Reference
Hosted surfaces
| Surface | Endpoints |
|---|---|
| Public | GET /__birdie /.well-known/* /api/auth/* Sign-in and consent pages |
| Authenticated | /traces /lessons /domain /api/admin/users |
| MCP | POST /mcp capture_correction check_guidance merge_lesson promote_lesson ask_lesson |
Reference
Development
Build and verify.
bun install --frozen-lockfile
bun run build
bun test