CodePulse——面向AI编码工具的令牌高效代码库索引器
CodePulse是一个开源的代码库索引工具，通过维护持久的、基于git差异的索引，为AI编码助手（如Claude Code、OpenAI Codex CLI、Cursor等）在会话启动时注入紧凑的快照，从而节省60-80%的令牌预算。它支持任务感知排序、git感知排序和自动预算功能，并提供了CLI、MCP服务器等多种集成方式。
文章情报
要点
- 节省AI助手60-80%的探索令牌，通过预构建快照。
- 支持多种AI工具：Claude Code、Codex CLI、Cursor等。
- 功能包括任务感知排序、git感知排序和自动令牌预算。
- 使用Tree-Sitter解析并存储为SQLite索引，增量更新。
为什么重要
这条新闻值得关注，因为节省AI助手60-80%的探索令牌，通过预构建快照。
技术影响
可能影响模型选型、推理成本、产品能力和评测基准。
CodePulse是一个创新的开源代码库索引工具，旨在解决AI编码助手在理解代码库时消耗大量令牌的问题。在每次新会话中，AI助手通常需要花费60-80%的令牌预算来探索仓库结构，而CodePulse通过维护一个持久的、基于git差异的索引，在会话启动时注入一个紧凑的代码库快照，从而大幅减少不必要的令牌消耗。
该工具适用于多种AI编码助手，包括Claude Code（作为技能）、OpenAI Codex CLI（通过管道或AGENTS.md）、Cursor和Continue.dev（通过MCP服务器）以及其他支持CLI输出的工具。其核心优势在于通过预建的快照避免了AI助手逐文件探索的需求，显著降低了令牌开销。
CodePulse提供了一系列实用命令，如codepulse update更新索引，codepulse context生成上下文快照，codepulse search搜索导出符号，以及codepulse stats查看索引统计。还支持codepulse watch自动更新和codepulse install-hooks安装git钩子实现提交后自动更新。
智能上下文生成是CodePulse的一大亮点。它通过层次化生成器，根据令牌预算从最重要到最不重要的顺序填充内容：仓库概览、目录映射、符号表、导入图。文件排名基于任务相关性（通过--task参数）和git文件修改频率，确保最有用的内容优先放入预算内。--auto参数可根据仓库复杂度自动调整令牌预算，小巧的仓库甚至会被完全跳过。
集成方式灵活多样。对于Claude Code，可以直接使用CLAUDE.md或指定上下文文件；对于Codex CLI，可以通过AGENTS.md或别名实现自动上下文注入；对于Cursor等工具，则通过MCP服务器配置。
技术实现上，CodePulse使用Tree-Sitter解析所有源文件，提取导出符号、导入关系和紧凑的文件摘要，存储到SQLite数据库中。每次更新只需重新解析变更的文件，50k行的仓库可在毫秒级完成更新。索引按仓库隔离存储，确保每个项目的独立性。
CodePulse采用MIT许可证，包分为核心引擎、CLI和MCP服务器三个部分，均由TypeScript编写。