waypoint

github/logo.svg" width" height="40" alt="Waypoint logo"> # Waypoint Waypoint 读取您的本地 Claude Code 会话历史，并从中提炼出隐藏的架构决策：做出了什么决定，为什么做出这些决定，以及哪些决定被放弃。它可以回顾您已经存在的会话，因此无需事先进行任何配置。 ## 为什么使用Waypoint 与编码代理的对话中充满了实际的工程决策，例如由于特定原因而选择一个库而不是另一个库，这些决策在会话结束时就会被埋没在聊天记录中。Waypoint 会在之后挖掘这些历史记录，并将其转化为您可以阅读、搜索和查询的内容。 ## Waypoint 的功能 - **`waypoint status`**: 免费预览已存在多少会话，有多少是新的，以及已经存储了什么，以便您在运行 `generate` 命令（由于它调用 `claude -p`，因此会产生少量成本）之前了解会发生什么。 - **`waypoint generate`**: 扫描该项目的 Claude Code 会话，并将新的会话提炼成结构化的决策（标题、做出了什么决定、为什么做出这些决定、放弃了什么、受影响的文件），并存储在该项目专用的本地 SQLite 数据库中。 - **`waypoint ui`**: 一个本地网页，列出这些决策，按会话或按日期分组，每个决策都有支持证据，如果相关代码自决策以来已更改，则会发出警告。 - **`waypoint mcp`**: 一个只读 [MCP](modelcontextprotocol.io) 服务器任何代理（包括 Claude立即回答“为什么这样构建从代码中猜测。 waypoint export` / `waypoint import`**: 与同一仓库中的协作者分享提炼的决策。Claude Code 会话仅存在于创建它们的机器上，因此这是两个在同一项目上工作的协作者看到彼此推理的方式。 ## 安装 ```bash npm install -g waypoint-cli waypoint setup ``` `waypoint setup` 会为这台机器上的每个项目注册一次 MCP 服务器，因此您无需为每个仓库重复此操作。 其他安装方式： ```bash # 无需安装即可试用 npx waypoint-cli setup # 使用其他包管理器 pnpm add -g waypoint-cli yarn global add waypoint-cli bun add --cli # 从源码编译 git clone https://github.com/ramantillac/waypoint waypoint npm install && npm run build npm link ``` ## 使用方法 在您要获取决策的项目中运行以下命令： ```bash waypoint status # 免费预览：找到的会话数，新增会话数，无成本 waypoint generate # 将新会话提炼成决策 waypoint generate --since 2026-07-01 # 仅考虑从该日期开始的会话 waypoint generate --model haiku # 使用更便宜/更快的模型（也接受 sonnet、opus、fable 或完整的模型名称） waypoint ui # 在 http://localhost:4173 浏览决策 waypoint export --author "" # 输出 waypoint-export>.json waypoint import waypoint-export-2026-07-13.json # 合并协作者的决策 ``` 每个项目都拥有自己的独立 `.waypoint/waypoint.db`，因此决策不会跨项目混淆。 ## 作为 MCP 服务器使用 `waypoint setup` 已经为这台机器上的每个项目注册了服务器，因此大多数情况下无需其他操作。要确认已连接，请运行 `claude mcp list` 并在输出中查找 `waypoint`。 从那里开始，只需提问即可。打开（或重启）一个 Claude Code 会话，位于运行 `waypoint generate`中，然后询问类似“构建？”或“为什么我们 X？”而无需提及。代理应该会自动使用MCP 工具由 Claude加载，因此在某些情况下首先检查代码并需要 waypoint MCP”）在会话中第一次使用。 要直接测试不依赖于代理决定使用它，请使用 [MCP Inspector://modelcontextprotocol.io/docs/tools/inspector): ```bashpx @modelcontextprotocol/inspector waypoint mcp ``` 这将本地 Web 界面，三个工具（`search_decisions`、`list_timeline`、`isions_by_file`），您可以直接调用，并带参数 JSON 响应。 ## 工作原理 `waypoint generate`~/.claude/projects/<-path>/*.jsonl` Claude Code 已经在本地会话历史记录，并将每个的记录通过管道传递aude -p`，一个 JSON 模式来化输出。它只保留模型决策，并附上逐字引用；如果模型无法引用，则会将其删除而不是报告操作都在本地运行：除非您明确运行 `waypoint，否则不会有会话。 ## 要求 ≥ 22（使用内置的 `node 模块，因此没有需要原生依赖项） - [Claude Code](https://claude-code) 已安装并已身份 `git`（可选；启用“决策以来已修改”的警告，如果项目不是 git，则静默跳过） ## 平台支持 已在 Windows 和 Linux 上验证。尚未在 macOS 上测试，但实现中没有任何特定于 Windows内容，因此相同的会话目录查找和仅限应该也能在 macOS 上运行。 MIT ## 作者 由 [ Mantilla](jamantillac构建。[GitHub](https://githubandramantillac) · [LinkedIn](https://www.linkedin.com/in-alejandra-mantilla/)