原站网页截图，页面可能随时间更新。
codemap 关注代码库中不容易仅凭源文件直接看出的结构信息：项目有哪些目录和文件、某个文件被哪些位置引用，以及与特定描述相关的代码在哪里。它通过项目扫描和依赖分析整理这些关系，为编码代理在开始会话、修改代码前或用户主动查询时提供项目上下文。
用途与适用场景
在阅读或修改较大的代码库时，仅查看单个文件往往难以判断改动影响范围。codemap 可以展示项目的文件组织方式，分析某个文件的导入者，并提示其是否属于被大量引用的枢纽文件。对于需要理解陌生项目、评估修改波及范围、定位实现某项行为的代码，或希望编码代理获得架构上下文的场景，这些信息可以作为源代码之外的结构参考。
工具也适合需要明确表达分析可信度的工作流程。依赖查询会附带 complete、partial 或 unavailable 等覆盖状态，并说明未能可信处理的来源，使“没有其他文件依赖它”与“当前无法判断”保持区别。
准备与上手
codemap以单一静态二进制形式提供。官方示例使用 Homebrew 安装后进入代码仓库，在仓库目录执行 setup；该命令用于为工具发现的代理配置 hooks、MCP 和 skills。随后可运行 doctor 检查连接配置。其他 MCP 客户端可以直接以 stdio 方式启动 codemap mcp。
完成基本配置后，可在项目目录运行 codemap 查看项目概览，也可以针对指定文件查询导入者，或使用 find 加上描述文字查找相关代码。使用前应先进入目标仓库所在目录，以便工具围绕该项目建立结构信息。
主要功能
运行项目概览命令时，codemap 会显示文件数量、项目大小、主要扩展名，并以树状形式呈现目录及其文件规模。导入者查询可以指出指定文件被哪些文件引用，统计引用数量，标记高影响的枢纽文件，并给出覆盖状态。
find 功能用于按文字查找代码位置。结果会依据路径和符号匹配进行排序，并标注命中的导入者数量；这类查找属于词法匹配，结果会明确说明这一点。工具还可通过 MCP 与编码代理衔接，在会话开始、编辑前或收到请求时提供项目位置、依赖关系和功能定位等信息。
分析边界与使用限制
codemap 的依赖图并不等同于绝对完整的项目事实。分析结果可能是 complete、partial 或 unavailable；当部分来源无法可信处理时，工具会保留相应状态，而不是把不确定结果当成完整关系。find 的结果是词法层面的匹配，命中位置不必然代表完整的语义调用关系。
它主要围绕代码库中的导入关系、项目成员关系、导出映射和路径别名等结构信息工作。实际可获得的结果取决于项目结构以及扫描器能够解析的内容，因此在使用依赖结论判断改动影响时，应同时关注命令输出的覆盖状态和提示信息。
codemap 会把不确定的依赖分析当成完整结果吗？
不会。依赖回答会标注 complete、partial 或 unavailable，并区分没有发现依赖与无法可靠判断的情况。
find 查找的是完整语义关系吗？
不是。find 按路径和符号进行词法匹配，结果会明确标注为 Lexical only。