Wayfinder
io.github.WBXWHTPublished by GitHub account WBXWHTv0.3.3Updated Oct 24, 2026
Read local AI coding paths, decisions, and branches as an in-host voyage map.
Overview
Wayfinder is a local-first desktop app that maps how AI coding sessions evolved, exposing that voyage map to an assistant in the host.
- What you can do
- Read local AI coding paths, decisions and branches as an in-host voyage map.
- Review project maps that group related Codex and Claude Code sessions into separate voyages.
- Inspect branches, failures, decisions, validation and source-linked details for conversations, tool activity and files.
- Replay real file changes recorded in a source session.
- Keep every recorded turn tied to its original source without inventing missing history or diffs.
- When to use it
- Useful when you want an assistant to look back over how a project actually reached its result across Codex or Claude Code sessions, including abandoned attempts and the evidence that changed direction, rather than only the latest answer.
- Requirements
- Runs as a local process on the user's machine (stdio), distributed as an MCP bundle; desktop only. The companion desktop app must be installed and running, with history stored under the user's home directory. Current collectors support Codex and Claude Code session history. No account, API key or environment variables are declared.
Installation
In SourceWeft
- Open Wayfinder in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Wayfinder
[Wayfinder — visual history for AI collaboration]
See how your work with AI actually evolved.
Wayfinder is a local-first desktop app that turns work with AI into a visual history of how a project reached its result. Goals, alternative attempts, failures, decisions, validation, and artifacts stay connected instead of disappearing into separate chats.
Wayfinder is designed for AI collaboration across coding, research, writing, design, and other project work. The current early-access collectors support Codex and Claude Code.
Download Wayfinder · Website · Get started · AI collaboration history · Integrations · Updates · Security · Privacy · Report an issue
No account. No telemetry. No cloud sync.
[Wayfinder showing a simulated AI collaboration voyage with failed and successful branches]
Why Wayfinder
AI tools are good at producing the next answer. They are less useful at showing why one approach worked, why another failed, or which evidence changed the direction of a project.
Wayfinder keeps that path reviewable:
- One project map across AI tools.
- Separate voyages for unrelated goals in the same workspace.
- Visible branches and failures instead of a cleaned-up success story.
- Real file-change replay when the source session contains an edit.
- Source-linked details for conversations, tool activity, files, and validation.
How It Works
- Install and open the desktop app.
- Keep working normally with your AI tools.
- Return to Wayfinder to review how the project evolved.
Related sessions are grouped locally. Every recorded turn retains its original source, and Wayfinder does not invent missing history or historical diffs.
Current collector details:
Downloads
Wayfinder early access is available for:
Download the latest installers and checksums from GitHub Releases. The current early-access builds are not store-signed; read the install guide before first launch.
Local By Default
Wayfinder stores normalized history, collection cursors, and project maps under
~/.wayfinder. There is no Wayfinder account, analytics service, advertising,
cloud sync, or cloud analysis in the current build.
Read PRIVACY.md before using confidential projects.
Current Scope
- Standalone desktop application for macOS and Windows.
- AI collaboration model spanning conversations, research, writing, design, coding, and other project work.
- Current public early-access collection from Codex and Claude Code.
- Project-level voyage grouping, branches, source details, and file-change replay.
- Early access: data formats and grouping behavior may continue to evolve.
Historical plugins, MCP bundles, IDE extensions, package-manager taps, and standalone CLI artifacts are not current product surfaces.
Development
The test suite covers collection, voyage grouping, the desktop renderer, trackpad pan and zoom, detail inspection, and narrow-screen behavior.
Read CONTRIBUTING.md before opening a pull request. Public copy and screenshot rules live in docs/PUBLIC-PRESENTATION.md.
Source: README.md at commit 7c5eb95
Tools
0Version history
1- v0.3.3LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts