Free on macOS

Hand off to agents.
Keep your focus.

Plan changes the way you already work, with full context attached. Hand them off when they're ready and keep your head in the work, not in prompt management.
Works with Claude Code, Codex, Cursor, and any agent that connects over MCP.

Download for Mac See how it works

Portfolio site

Run New Item
▾To Do3
Add alt text to the gallery imagesClaude
Rework the contact form copyPlan
Tighten hero spacing on tabletfigma.com
▾In Progress1
Fix the nav overlap on mobilelocalhost:3000
▾Done2
Dark footer with the right hairline
Swap placeholder images for real shots

Recipe app

Run New Item
▾To Do2
Empty state for saved recipes
Timer resets when the app backgroundsClaude
▾In Progress1
Metric / imperial ingredient toggle
▾Done1
Fix crash on step reorder

Client: Lakeview Tours

Run New Item
▾To Do2
Map pins overlap at zoom 12/tours
Add a wheelchair-access filterPlan
▾In Progress1
Booking form validation copy
▾Done2
Hero video autoplay on mobile
Fix the broken Instagram embed
How it works

Capture Everything, Hand It Off

From a pile of targeted feedback to shipped changes, in three steps.

1

Capture feedback

Drop in whatever frames the change best: a screenshot, a quick comment, a Figma link, even a full PRD. Pile on as much context as you want, so Claude has the full picture.

2

One Space per project

Spaces keep projects apart: your macOS app, its marketing site, a client build, each with its own list. Capture into the right one and feedback never gets crossed.

3

Claude works the list

Say “work this Space” in Claude Code. It takes each Item one at a time over MCP, marks it done, and links what changed. Items set to Plan get discussed first; Auto items it just builds.

Stay in flow

Plan in batches. Hand off.
Keep working.

Working with an agent shouldn't mean watching one. Punchlist turns scattered interruptions into one clean handoff, so noticing a fix never costs you the thing you were doing.

Capture in seconds, not sessions

Spotting a bug used to mean stopping to write a prompt. Now it's a screenshot and a sentence, filed before you lose the thread.

Walk away while it works

Your agent takes the queue one Item at a time and replies inside each one. Keep designing, keep building, or step out entirely.

Proof when it matters

For changes you want to see, your agent posts screenshots back to the Item for a quick sign-off. For the bugs you just want gone, it gets them done and notes what changed.

Bounded context

Your list grows.
Claude's context doesn't.

Paste everything into one prompt and the whole queue rides along from the first turn, worked or not. Punchlist hands Claude one Item at a time, so context stays flat and nothing gets skipped in the pile.

DROP EVERYTHING IN grows with your queue PUNCHLIST · ONE AT A TIME stays flat, worked Item only the rest wait until Claude needs them

We measured it side by side: growing the queue from 5 to 15 Items pushed the pasted prompt's peak context from 48k to 65k tokens, while Punchlist held flat at about 49k. The only fix silently dropped in the whole test was dropped by the giant prompt.

Capture

You Capture, Claude Builds

Grab a fix the moment you spot it, from wherever you are.

Right in the app

Drag in a screenshot, jot a sentence, or write a Markdown note, whatever's fastest the moment you spot a fix. The why gets captured right there, not reconstructed later.

Screenshot Watcher

Take a screenshot anywhere with ⌘⇧4 and Punchlist quietly offers to file it into a Space. No window to switch to, nothing to upload.

Web Capture for Chrome

Annotate any web page and send it straight into a Space with the free Web Capture extension.

Why Punchlist

Simple on purpose

A small, focused tool that stays out of your way.

Radically simple

Spaces, Items, a status. No teams, sprints, or boards. Just enough structure to hand work to Claude and track what's done.

Local-first & private

Everything lives in ~/.punchlist on your Mac. No account, no cloud, no telemetry.

Works with any MCP agent

One-click connect for Claude Code, Codex, Cursor, and VS Code, no Terminal. Your agent works the queue and replies inside each Item, so follow-ups happen where the context already is. Any other agent that connects over MCP takes a few lines of config.

Light on tokens by design

Claude takes Items one at a time and opens an Item's screenshots only while working it. A thirty-item list won't overload Claude or eat through your usage limits.

Hand off when you're ready

Ten fixes shouldn't cost ten interruptions. Collect them while your head is in the work, then pick the moment Claude gets the whole list.

Install

Up and Running in Two Minutes

1

Download & install

Grab Punchlist.dmg, open it, and drag Punchlist into your Applications folder.

2

Open it

Launch Punchlist. Because it's notarized by Apple, you'll see a friendly “macOS verified this app” prompt, then click Open. No scary warnings, no right-click tricks.

3

Connect your agent

The setup screen opens automatically. One click wires up the MCP server for Claude Code, and the same screen connects Codex, Cursor, and VS Code. Using something else? Two lines of config.

4

Restart your agent session

Quit and reopen your agent session so it picks up Punchlist. (Just this once.)

5

Create a Space & go

Make your first Space, capture a few Items, then tell Claude Code to “work this Space.” That's the loop.

Download Punchlist
FAQ

Questions, Answered

What exactly is Punchlist?
A tiny macOS app that catches your screenshots and notes as a running to-do list, then hands the list to your coding agent to work through one Item at a time. The clean hand-off between spotting a fix and shipping it.
Which coding agents work with it?
Any agent that connects over MCP, the standard coding agents use to talk to tools. Claude Code, Codex, Cursor, and VS Code connect in one click from the setup screen; anything else (Windsurf, Cline, Gemini CLI, and more) connects with a few lines of config. Capturing and organizing Items works without an agent, but the payoff is letting one clear the queue.
Is it really free?
Yes. Punchlist is free while it's early. It's a focused tool made by one person, shared with friends to learn what's useful. If that ever changes, the local capture you rely on won't be yanked out from under you.
Where does my data live? Is it private?
Your Punchlist data lives entirely on your Mac, in a folder at ~/.punchlist. There's no account, and nothing you capture ever leaves your machine. The only thing the app sends is anonymous usage counts (app opened, item created, tied to a random ID) to our own server, so we can tell whether Punchlist is being used. No third parties, no IP addresses stored, never your content. You can turn it off any time in Settings. This website keeps the same kind of anonymous count — a visit and a download click, tied to a random ID, nothing more.
Does it work on Intel Macs?
Yes. Punchlist is a universal app, so it runs natively on both Apple Silicon (M1 and later) and Intel Macs, on macOS 14 Sonoma and up.
How do updates work?
Punchlist updates automatically. It checks for new versions in the background and offers them with a one-click install, so you stay current without re-downloading anything.
Does a big list eat my Claude usage?
No, and that's much of the point. Screenshots live on your disk as file paths, and Claude loads an Item's images only when it starts working that Item. Items it hasn't reached cost just their one-line title, images are read once instead of pasted into one giant prompt up front, and nothing gets re-sent to remind Claude what you meant. Capture as much context as you like: tokens go to the Item being worked, not the queue behind it.
How is this different from Linear or a to-do app?
Linear plans work across a team. Punchlist plans work with one agent, and it's built for the hand-off itself: your agent takes Items one at a time so context stays lean, you choose per Item whether it plans first or just builds, and its replies land inside the Item they're about. No assignees, boards, or ceremony, just you and your agent.
How do I send feedback?
Please do. That's the whole point right now. Email tylerhathaway09@gmail.com with anything that's confusing, broken, or missing.

You Capture. Claude Builds.

Free, private, and about two minutes to set up.

Download for Mac