项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-09-30 · 当前星标 ★ 377
使用教程
环境要求
- macOS 或 Linux
- Go 1.21+（源码安装时）
安装与启动步骤
-
1装
macOS 走 brew，其他平台用 go install 并带编译标记
brew install cymbal -
2建索引
给仓库建一次索引，之后查询都走本地库
cymbal index . -
3查一个符号
按函数名找定义与调用点
cymbal investigate handleAuth -
4接进 agent
输出是纯文本，可直接喂给编码助手
如何确认成功
对同一个仓库，investigate 能在几秒内返回定义位置与调用链，结果与手工搜索一致。
注意事项
- 语言无关的代码导航工具，思路是建本地索引而不是每次全库 grep。
- 索引要重建才反映最新改动，提交后记得再跑一次。
- 用 go install 时要带全文检索的编译标记，否则搜索能力缺失。
- 没有图形界面，价值在于给智能体提供稳定的检索结果。
- Docker 方式适合不方便装 Go 的环境，挂载路径别写错。
核心亮点
- 基于 tree-sitter 做语法级解析，比纯文本 grep 更准确，能区分同名符号的不同作用域
- 语言无关设计，一套 CLI 覆盖多语言仓库，减少为每种语言装不同工具的成本
- 用 SQLite 做索引存储，检索速度快，且索引文件便于复用和增量更新
不足之处
- 项目处于早期，星标 325，生态和文档成熟度有限
- 索引构建对超大仓库的耗时和内存占用尚未有明确优化说明
- CLI 交互体验和查询语法可能需要一定学习成本
适用场景
- 在终端快速跳转到某个函数的定义处，替代打开重型 IDE
- 为 AI 编程 agent 提供代码符号检索能力，辅助其理解仓库结构
- 在 CI 或代码审查脚本中自动提取变更涉及的符号引用
替代项目
ctags、sourcegraph
同类项目推荐
ai-data-extractor
开源
一键导出 Claude Code、Cursor 等 AI 编程对话记录
Free open-source extractor for AI coding assistant chat histories. Supports Claude C···
vim-ai
开源
在 Vim 里直接对话 AI，写代码、改代码、问问题一步到位
AI-powered code assistant for Vim. OpenAI and ChatGPT plugin for Vim and Neovim.
flemma.nvim
开源
在 Neovim 里直接调用多模型 AI，边写代码边问，不切窗口
AI knowledge workbench for Neovim.
kodus-ai
开源
自由选模型，控成本，让 AI 审查代码更省心
Open source, self-hosted AI code review. Bring your own LLM.
alphacode
开源
免 API Key 的 AI 编程智能体，开箱即用改代码
Free MIT AI coding agent — no API key needed. Built-in free model, or bring Claude,···
ai-code-fusion
开源
一键把整个代码仓库打包成单文件，喂给 AI 更高效
Desktop app to process repository content into one file
OpenCursor
开源
在 VS Code 里用开源 AI 代理自动写代码、改项目
Open-source Cursor-like AI coding agent for VS Code - agentic chat, multi-provider L···
snap2txt
开源
一键把整个代码库打包成 AI 提示，省去复制粘贴的麻烦。
Fold your entire codebase into one LLM-ready prompt.
parrot.nvim
开源
在 Neovim 里直接和大模型对话，写代码不打断思路。
parrot.nvim - the plugin that brings stochastic parrots to Neovim.