v1.23.1 · open source · zero dependencies

What needs me next?

Birddog is a local-first inbox for developers. It looks through your git repos, GitHub, Jira, calendars, Slack and more, ranks what it finds with plain rules, and tells you why each thing is there.

# try it with made-up data, or point it at your own work
npx @marcusferrell/birddog --demo --open
npx @marcusferrell/birddog --open
Birddog's overview: load dial, open items, meetings and the last 14 days

One list, with its reasoning out loud

Work in progress hides everywhere: a branch you forgot to push, a review someone is waiting on, a ticket due tomorrow, a meeting in ten minutes. Birddog puts it in one list, ranked into Now, Today and Later, and every item says why it's there.

@ana-lopez requested your review 2 days ago · they are waiting on youRule: review requested of you over a day ago → Now

🧭Explains itself

Every item names the rule that put it there. No scores, no machine learning: rules you can read.

🏠Local-first

Runs on your machine, listens on 127.0.0.1, keeps state in JSON files you can read. No telemetry, no account.

🔒Read-only by default

It never pushes, comments or moves tickets. Replies to Slack and Teams are opt-in, with a 5-second undo.

⌨️Keyboard-first

j/k to move, x done, s snooze, z undo, ⌘K for everything else.

✨Ask Fetch

Ask "what needs me now?" in plain words. Fetch runs on Claude with your own key, remembers what you tell it, and shows its boundaries.

🔌Talks to your AI tools

birddog mcp lets Claude Code, Claude Desktop or any MCP client ask what needs you and triage items.

Local gitGitHubGitLabJira CloudLinearAzure DevOpsGoogle, Outlook & iCloud calendarsSentryPagerDutySlackMicrosoft TeamsDiscordThunderbird mail & calendarsMicrosoft To DoGoogle TasksTodoistGmail & Outlook mail, noise filteredDynatraceGrafanaJenkinsGitHub ProjectsConfluence

Board, worktrees and slots

See every ticket in its delivery lane, the worktree it lives in, and the dev or QA slot it runs on, at a glance.

▦Ticket board

Your Jira tickets in swimlanes you name, with how long each has sat in its status.

⎇Worktrees

Every git worktree with its ticket, changes, and how far it is from main, with flags for what needs a look.

🧪QA slots

Numbered test environments: which branch each one runs, and who has it.

🚀Launch slots

birddog slot start runs a copy of your app per worktree on its own ports, with a Claude Code skill to drive it.

Get started

You need Node 22 or newer. Nothing else: the package has no dependencies.

Look around first
npx @marcusferrell/birddog --demo --open
Point it at your work
npx @marcusferrell/birddog --open
It asks where you keep your code, then suggests connecting GitHub.
Connect it to Claude
claude mcp add birddog -- npx -y @marcusferrell/birddog mcp