Unblock: what this changes in the plan
Unblock roadmap · 48% → 49% done · completes 1 · adds 4 · changes 1
- Pull request comment: what merging does to the plan
oh-pr
Open the board with these tasks highlighted
Your agents keep the plan · you see where things stand
A live map of your project, kept by your agents. The plan is a dependency graph in your repo, .github/unblock.json. Your agents keep it current as they work; you see what's done, what's next, what's in the way, and how close a feature is. No tickets to groom, nothing to administer.
01 · The idea
Kanban columns can't say what waits on what. Unblock draws it, then does the arithmetic: which tasks are ready, which are blocked, and how close each blocked one is.
Arrows run from a prerequisite to the task that waits on it, so work flows left to right. Group related tasks under a parent.
The share of all the work upstream of it that's done, weighted by estimate. The landing page: 4 of 7 points upstream are done, so 57%.
Two prerequisites get done and the landing page goes from blocked to ready. Ready and blocked are worked out, never stored.
Links in and out of the group are kept on the folded card, with its progress on the front. You can also dive into a group and see only what's inside.
Every task becomes a circle sized by its estimate, and a group becomes an outline around its tasks. Drag circles to untangle it.
02 · Agents
A one-file CLI reads and edits the board, validates every write and refuses loops. The loop is four commands, and unblock point lets the agent show you what it means.
next lists ready tasks, most unblocking first.set <id> doing before starting.point rings it in your viewer with a note.set <id> done prints what just became ready.It explains how to install the CLI, start a board for your repository, work through it, and show you progress. It's written as a Claude Code skill, so you can save it as .claude/skills/unblock/SKILL.md. For any other agent, paste the link.
03 · MCP
unblock mcp runs the CLI as an MCP server. Its show_board and point tools come with an MCP App, so the interactive board appears in the conversation with the pointed tasks ringed and the agent's note beside them.
$ claude mcp add unblock -- python3 ~/.local/bin/unblock mcp04 · Any repo
Commit a board as .github/unblock.json and open https://unblock.esh.sh/gh/<owner>/<repo>. The page reads the board straight from GitHub. There's no sign-up, no server storage, and nothing to install.
.github/unblock.json with a starter board already filled in.#point=<id>¬e=<text> to any board address to link to a pointed task.05 · The file
Commit the board together with the code change it describes, so the history shows progress. This is a real task from Unblock's own roadmap, which is kept as an Unblock board.
{ "format": "unblock/v1", "title": "Unblock roadmap", "tasks": [ … { "id": "ln-landing", "title": "Landing page at unblock.esh.sh that explains the idea", "status": "todo", "parent": "launch", "dependsOn": ["gh-dogfood", "joy-share", "ln-examples"], "estimate": 2 } ]}
unblock/v1, with a JSON Schema. Any other fields you add are kept as they are.unblock validate names the ids involved.06 · Pull requests
Add one GitHub Action and every pull request gets a comment: which tasks it finishes, what it unblocks and what it adds, with a picture of those tasks drawn like the app.
The comment's real picture for the change that added this feature to Unblock's own roadmap (2755ba5 → f128f43).
$ unblock init --ciunblock diff main...feature shows the same in your terminal, and /gh/owner/repo/compare/main...feature in the app.07 · Get started
Your agent can do the setup. Or run it yourself: these are the same commands the skill uses.
It installs the CLI, drafts a board from what you asked for, the README and the code, and commits it.
https://unblock.esh.sh/skill.md
Once per machine (macOS and Linux; Windows below). It checks the download against the release's sha256 and puts unblock on your PATH. Then create a board and open it in the browser; edits there save to the file.
curl -fsSL https://unblock.esh.sh/install.sh | sh
irm https://unblock.esh.sh/install.ps1 | iex
unblock init unblock view
The board in a pane beside the conversation, the plan above the prompt, and the CLI and MCP server with it. Other MCP clients (Claude Desktop, Cursor, Copilot) run the server with uvx.
claude plugin marketplace add sqvist-ab/unblock claude plugin install unblock@unblock
uvx --from unblock-cli unblock mcp
The app opens with an example board. Or browse a repository's board at unblock.esh.sh/gh.