JordanCoin/codemap

a project brain for your AI. Give LLMs instant architectural context without burning tokens

What it solves

Codemap 为 LLM 提供代码库的架构上下文，而不会消耗过多的 Token。它能防止 AI Agent 在处理大型仓库时，因无法追踪项目结构、依赖关系和近期变更而迷失方向。

How it works

它会分析项目结构并生成精简、高信号的摘要。它使用 ast-grep 进行跨 18 种语言的依赖分析，并提供代码的多种视图：树状图视图、diff 视图（与 main 分支的差异）以及依赖流视图。

为了与 AI 工具集成，它提供了一个 Model Context Protocol (MCP) 服务器、一个 HTTP API 以及一个通用的 JSON 上下文协议。它还具有一个“技能框架”(skills framework)，通过 Markdown 文件提供基于项目语言和用户意图的上下文感知指导。

Who it’s for

使用 AI 编程助手（如 Claude Code、Cursor 或 Windsurf）的开发者，他们需要他们的 Agent 具备对项目整体架构以及变更的“爆炸半径”的更好理解能力。

Highlights

  • Multi-Agent Handoff: 保存分层产物，以便您可以在不同的 AI Agent 之间切换，而不需要重新向 them 简报当前进度。
  • Intelligent Routing: Classify 用户意图（例如：重构 vs. 修复 Bug）以呈现风险分析和相关技能。
  • Intelligence Flow: 可视化代码如何连接并识别出被大量导入的“枢纽”文件。
  • Remote Repo Analysis: 分析公开的 GitHub 或 GitLab 仓库，而无需进行完整的本地克隆 (clone)。
  • Extensible Skills: 允许用户在 Markdown 文件中定义自定义的 AI 指导，这些指导会根据关键字或语言而激活。