{"id":47619419,"url":"https://github.com/usewayfind/wayfind","last_synced_at":"2026-04-14T22:01:23.470Z","repository":{"id":344657090,"uuid":"1182617168","full_name":"usewayfind/wayfind","owner":"usewayfind","description":"Team decision trail for AI-assisted development","archived":false,"fork":false,"pushed_at":"2026-04-04T20:40:33.000Z","size":786,"stargazers_count":0,"open_issues_count":12,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-04T22:44:34.753Z","etag":null,"topics":["ai","ai-engineering","claude-code","decision-trail","developer-tools","session-memory","slack-bot","team-context"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/wayfind","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/usewayfind.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-15T18:53:45.000Z","updated_at":"2026-04-04T20:40:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/usewayfind/wayfind","commit_stats":null,"previous_names":["usewayfind/wayfind"],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/usewayfind/wayfind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usewayfind%2Fwayfind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usewayfind%2Fwayfind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usewayfind%2Fwayfind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usewayfind%2Fwayfind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/usewayfind","download_url":"https://codeload.github.com/usewayfind/wayfind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usewayfind%2Fwayfind/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31817128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-engineering","claude-code","decision-trail","developer-tools","session-memory","slack-bot","team-context"],"created_at":"2026-04-01T21:55:28.753Z","updated_at":"2026-04-14T22:01:23.418Z","avatar_url":"https://github.com/usewayfind.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wayfind\n\n**Team memory for AI-assisted engineering.**\n\nYour AI coding assistant forgets everything between sessions. Wayfind gives it a memory — for you and your whole team.\n\nPlain markdown files. No infrastructure. Works with any MCP client.\n\n[![CI](https://github.com/usewayfind/wayfind/actions/workflows/ci.yml/badge.svg)](https://github.com/usewayfind/wayfind/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/wayfind)](https://www.npmjs.com/package/wayfind)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\n**Works with:** Claude Code | Cursor | Any MCP client\n\n---\n\n## The Problem\n\nAI coding assistants are stateless. Every session starts cold. The decisions you made yesterday, the architecture you agreed on last week, the reason you chose Postgres over Mongo — gone. You re-explain, or the AI guesses wrong.\n\nNow multiply that across a team. Five engineers, each with their own AI sessions, none of them aware of what the others decided. Your PM reads the standup notes, but the AI that writes the code doesn't.\n\n## What Wayfind Does\n\n**For you:** Sessions resume where they left off. Decisions are extracted automatically and become searchable history. Drift detection flags when work veers from the stated goal.\n\n**For your team:** A daily digest summarizes what everyone shipped, decided, and discovered — tailored per role (engineering, product, design, strategy). Team members who use AI tools get session memory directly. Everyone else gets a Slack digest.\n\n**For your AI tools:** An MCP server exposes your team's full decision history as tools. Claude, Cursor, or any MCP client can search decisions, browse by date, and retrieve context — no file reading or guessing.\n\n\u003c!-- TODO: demo GIF here — see #175 --\u003e\n\n---\n\n## Quick Start\n\n### Option A: Claude Code plugin\n\n```\n/plugin marketplace add usewayfind/wayfind\n/plugin install wayfind@usewayfind\n/wayfind:init-memory\n```\n\n### Option B: npm (works with any AI tool)\n\n```bash\nnpm install -g wayfind\nwayfind init\n```\n\nYour next AI session has memory. That's it.\n\n---\n\n## How It Works\n\n### Plain Files, Not Databases\n\nAll context is plain markdown in directories you control:\n\n```\n~/.claude/\n  global-state.md           # Thin index — always loaded at session start\n  memory/\n    journal/YYYY-MM-DD.md   # Daily decision log\n\n\u003crepo\u003e/.claude/\n  team-state.md             # Shared team context (committed)\n  personal-state.md         # Your context (gitignored)\n```\n\nNo proprietary formats. No vendor lock-in. `grep` works if Wayfind breaks.\n\n### The Session Loop\n\n1. **Start** — AI reads state files, summarizes context, asks \"What's the goal?\"\n2. **Mid-session** — If work drifts from the goal, the AI flags it.\n3. **End** — Decisions are extracted, written as journal entries, and synced to the team repo — automatically via hooks.\n\n### Team Digests\n\nEach role sees the same data through a different lens:\n\n- **Engineering**: What shipped, what drifted, what patterns emerged\n- **Product**: What shipped vs. planned, discovery signals\n- **Strategy**: Cross-team patterns, drift trends, capability gaps\n\nThe digest posts to Slack. Anyone on the team — engineer, PM, CEO — who uses an AI tool gets session memory. Everyone else gets the digest.\n\n### MCP Server\n\nWayfind includes an MCP server that exposes team context to any MCP-compatible AI tool. Auto-registered during `wayfind init`.\n\n**Tools:**\n\n| Tool | What it does |\n|------|-------------|\n| `search_context` | Search decisions by query, date range, author, or repo. Semantic or browse mode. |\n| `get_entry` | Retrieve the full content of a specific entry. |\n| `get_signals` | Recent GitHub, Intercom, and Notion activity. |\n| `get_team_status` | Current team state: who's working on what, active projects, blockers. |\n| `add_context` | Capture a decision or blocker from the current session. |\n| `record_feedback` | Rate whether a result was useful (improves future retrieval). |\n\nEach team member's MCP server searches their local content store — journals synced from the shared team repo, with local embeddings generated automatically. No infrastructure required.\n\n---\n\n## Signal Connectors\n\nPull external context into digests:\n\n```bash\nwayfind pull github       # Issues, PRs, Actions status\nwayfind pull intercom     # Support conversations, tags, response times\nwayfind pull notion       # Pages, databases, comments\nwayfind pull --all        # All configured channels\n```\n\n---\n\n## Team Setup\n\n```\n/wayfind:init-team\n```\n\nThis walks you through creating a team, setting up profiles, creating a shared team-context repo, and configuring Slack digest delivery. Multi-team support built in — bind repos to different teams, each with isolated context.\n\n---\n\n## Tool Support\n\n| Tool | How | Setup |\n|------|-----|-------|\n| **Claude Code** | Plugin (full support) | `/plugin marketplace add usewayfind/wayfind` |\n| **Cursor** | MCP server | `wayfind init` auto-registers |\n| **Any MCP client** | MCP server | `wayfind init` auto-registers |\n| **Slack** | Bot + digests | `wayfind bot --configure` |\n\n---\n\n## What's Open Source\n\nEverything that runs on your machine is open source (Apache 2.0).\n\n| Open Source (this repo) | Commercial (future) |\n|---|---|\n| CLI, plugin, and all commands | Cloud-hosted team aggregation |\n| Session protocol and journal extraction | Managed digest delivery |\n| Content store, semantic search, MCP server | Web dashboard |\n| Signal connectors (GitHub, Intercom, Notion) | SSO and tenant isolation |\n| Digest generation (your API key) | |\n| Slack bot (self-hosted) | |\n| Multi-team support | |\n\n---\n\n## Architecture\n\n- [Data Flow](docs/architecture/data-flow.md) — sessions to digests\n- [Query Path](docs/architecture/query-path.md) — how queries reach the content store\n- [Content Store](docs/architecture/content-store.md) — indexing, search, schema\n- [Principles](docs/architecture/architecture-principles.md) — the eight constraints\n- [Signal Channels](docs/architecture/architecture-signal-channels.md) — connector architecture\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Good first contributions:\n\n- **Specializations** for AI tools (Windsurf, Aider, Continue)\n- **Signal connectors** for new tools (Linear, Jira, Slack, HubSpot)\n- Bug reports and feature requests via [issues](https://github.com/usewayfind/wayfind/issues)\n\n---\n\n## License\n\nApache 2.0. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusewayfind%2Fwayfind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fusewayfind%2Fwayfind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusewayfind%2Fwayfind/lists"}