Show HN: Minimap – a local UI for repo roadmap files(github.com)

1 pointsby margolis204 maanden geleden1 comments

Show HN: Minimap – a local UI for repo roadmap files

https://github.com/rore/minimap

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

1 comments

margolis204 maanden geleden

Some more details about how this is structured:

Minimap is a portable package, which includes an agent skill, examples of feature and roadmap files, and a small node server for the UI. You point your agent to the skill, and just start the server in your project.

The file structure is quite simple: - board.md owns groups and item order - scope.md owns the current-focus narrative - features/.md owns committed or active work - ideas/.md owns uncommitted or parked work

The UI provides some views over these files. A regular list view, and also a column (kanban-like) view for easier planning. It allows viewing and also editing the features and the board.

I still do most of the planning work in conversations with the agent, but I find it very useful to be able to have this clear visualization of the features we produce.