
wayfinder-maps¶
A CLI and star-map viewer for wayfinder maps: the markdown planning memory an agent leaves under .plan/<effort>/ while it charts a large effort as a graph of investigation tickets, resolved one per session.
- The wayfinder method and its skills were created by Matt Pocock in mattpocock/skills. This repo ships adapted copies, so one install gets you the method and the tools.
- The CLI and viewer were created by John Goh in rengwu/wayfinder-maps. This fork extends both so a map carries on into implementation, see fork vs upstream.
Full docs live at ramseskools.github.io/wayfinder-maps.
Install¶
The skills, as a Claude Code plugin:
/plugin marketplace add RamsesKools/wayfinder-maps
/plugin install wayfinder-maps@wayfinder-maps
The binary on macOS or Linux, then the matching skills for Claude Code, GitHub Copilot or Codex:
curl -fsSL https://raw.githubusercontent.com/RamsesKools/wayfinder-maps/main/scripts/install.sh | bash
wayfinder-maps install-skill
Windows, pinned releases, drop-in skills, updates and building from source are on the install page.
When a newer release exists, commands end with a short notice on stderr with the update command for your install (terminal only, never in CI):

Silence it by setting "updateCheck": false in settings.json, or turn off Update check in the viewer's settings, see Outdated notice.
Usage¶
- Ask your agent to run
/wayfinder-mapson a big, foggy effort. It charts the map under.plan/<effort>/. - Each later session claims a ticket from the frontier and resolves it.
- Follow along from the terminal or the star-map:
wayfinder-maps status .plan/<effort> # resolved, in flight, and ready to claim
wayfinder-maps lint .plan/<effort> # does the map still tell the truth?
wayfinder-maps app .plan/<effort> # the star-map in a native window (serve for a browser)
The guide covers every command, the map format and maps kept as GitHub issues.
Contributing¶
- Vote on issues with a thumbs-up reaction, the most wanted go first.
- Raise ideas and ask questions in Discussions, under Ideas or Q&A.
Credits and license¶
MIT, see LICENSE. The CLI and viewer are by John Goh, the wayfinder method and skills by Matt Pocock (MIT, see skills/LICENSE). This is a fork of rengwu/wayfinder-maps and is not merged back upstream.