# Wayfinder

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/WBXWHT/wayfinder  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/wayfinder

## Description
Read local AI coding paths, decisions, and branches as an in-host voyage map.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "wayfinder": {
    "command": "npx",
    "args": ["-y","wayfinder"]
  }
}
```

## Documentation & README

# Wayfinder

![Wayfinder — visual history for AI collaboration](https://raw.githubusercontent.com/WBXWHT/wayfinder/HEAD/docs/assets/public/wayfinder-social-preview-2k.png)

**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.

[![CI](https://github.com/StayCurious-Xuan/wayfinder/actions/workflows/ci.yml/badge.svg)](https://github.com/StayCurious-Xuan/wayfinder/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/StayCurious-Xuan/wayfinder?include_prereleases&label=release)](https://github.com/StayCurious-Xuan/wayfinder/releases)
[![License](https://img.shields.io/github/license/StayCurious-Xuan/wayfinder)](LICENSE)

[Download Wayfinder](https://github.com/StayCurious-Xuan/wayfinder/releases/tag/alpha-v0.3.17) ·
[Website](https://wayfinder-ai.pages.dev) ·
[Get started](https://wayfinder-ai.pages.dev/getting-started) ·
[AI collaboration history](https://wayfinder-ai.pages.dev/ai-collaboration-history) ·
[Integrations](https://wayfinder-ai.pages.dev/integrations) ·
[Updates](https://wayfinder-ai.pages.dev/updates) ·
[Security](https://github.com/WBXWHT/wayfinder/blob/HEAD/SECURITY.md) ·
[Privacy](https://github.com/WBXWHT/wayfinder/blob/HEAD/PRIVACY.md) ·
[Report an issue](https://github.com/StayCurious-Xuan/wayfinder/issues)

**No account. No telemetry. No cloud sync.**

![Wayfinder showing a simulated AI collaboration voyage with failed and successful branches](https://raw.githubusercontent.com/WBXWHT/wayfinder/HEAD/docs/assets/public/wayfinder-voyage-overview-2k.png)

## 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

1. Install and open the desktop app.
2. Keep working normally with your AI tools.
3. 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:

- [Codex session history](https://wayfinder-ai.pages.dev/integrations/codex)
- [Claude Code session history](https://wayfinder-ai.pages.dev/integrations/claude-code)

## Downloads

Wayfinder early access is available for:

| Platform | Build | Download |
| --- | --- | --- |
| macOS | Apple Silicon | [DMG](https://github.com/StayCurious-Xuan/wayfinder/releases/download/alpha-v0.3.17/Wayfinder-Alpha-0.3.17-macOS-aarch64.dmg) |
| macOS | Intel | [DMG](https://github.com/StayCurious-Xuan/wayfinder/releases/download/alpha-v0.3.17/Wayfinder-Alpha-0.3.17-macOS-x86_64.dmg) |
| Windows | x64 | [EXE](https://github.com/StayCurious-Xuan/wayfinder/releases/download/alpha-v0.3.17/Wayfinder-Alpha-0.3.17-Windows-x86_64.exe) |

Download the latest installers and checksums from
[GitHub Releases](https://github.com/StayCurious-Xuan/wayfinder/releases). The current
early-access builds are not store-signed; read the
[install guide](https://github.com/WBXWHT/wayfinder/blob/HEAD/docs/INSTALL.md) 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](https://github.com/WBXWHT/wayfinder/blob/HEAD/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

```bash
npm ci
npm run check
npm run companion:prepare
npm run companion:build
```

The test suite covers collection, voyage grouping, the desktop renderer,
trackpad pan and zoom, detail inspection, and narrow-screen behavior.

Read [CONTRIBUTING.md](https://github.com/WBXWHT/wayfinder/blob/HEAD/CONTRIBUTING.md) before opening a pull request. Public
copy and screenshot rules live in
[docs/PUBLIC-PRESENTATION.md](https://github.com/WBXWHT/wayfinder/blob/HEAD/docs/PUBLIC-PRESENTATION.md).