GitHub Repository

Local-first roadmap and spec-review workbench for humans and agents. Repo-local roadmap files plus per-file spec sessions for line-anchored review and suggestions.

2 starsJavaScript

Minimap – a local UI for repo roadmap files

Name: Minimap – a local UI for repo roadmap files
Availability: InStock
Author: margolis20

by margolis20·Mar 15, 2026·1 point·1 comment

Visit Project View on HN

AI Analysis

●●SolidCozyNiche Gem

Planning stays in-repo as markdown instead of scattered across chat history.

Strengths

•Files are canonical source of truth, git provides version history
•Lightweight local UI avoids introducing separate PM tool with hidden state
•Agent skill enforces limited structure for consistent roadmap file formatting

Weaknesses

•Extremely narrow audience: only matters if you already plan in markdown
•One GitHub star indicates very early stage with unproven workflow

Post Description

I built this for myself to work on my project roadmap together with AI agents, and it might be useful to others.

When working on features and the roadmap with the agent, I found that I miss a nice UI to be able to see what we planned, and maybe make some changes. Most of the planning is done by talking to the agent, but as a human, I need a way to get a nice view on top of this.

So I built Minimap as a small local UI that sits on top of repo roadmap files. It comes together with a skill that guides the agent towards a very limited structure of how to manage the files.

It intentionally does not try to replace larger project planning tools. It’s mainly for repos where planning already lives in markdown and you want a better review/edit UI around it.

Repo: https://github.com/rore/minimap