rgctl：面向 LLM 智能体的代码知识图谱与调用关系查询工具

sshaaf/rgctl · A code knowledge graph built for LLM agents — accurate answers, minimal tokens, maximum speed

GitHub原文发布未知首次收录 2026-10-22上架 2026-10-22 07:02

ELI5：它是什么，解决什么问题

rgctl 是用 Rust 实现的代码知识图谱命令行工具，为 LLM 编程智能体提供确定性的结构化查询能力。索引一次后，可通过紧凑的 JSON 输出查询调用者、传递影响范围（blast-radius）、控制流与数据流切片、克隆检测、社区聚类以及 PR 调用路径变化，减少智能体反复用 grep 搜索整个代码库并读取整文件带来的 token 开销。项目使用 tree-sitter 解析器，覆盖 14 种一级语言以及 ERB、Markdown，并支持将技能包安装到 Cursor、Claude、Codex 等编码智能体。

# 静态分析 # Tree-sitter # token 优化 # 智能体基础设施 # 代码知识图谱

核心能力与快速开始

★ 23 · Rust

能做什么: 对代码仓库建立一次索引后，输出结构化 JSON，供智能体和脚本查询函数、类型等符号，以及调用者与被调用者等类型化关系；提供 blast-radius 影响面分析，CFG/PDG/支配关系和前向、后向程序切片（需启用 discover --with-cfg），克隆检测（exact/bloom/fragment）、中心度指标与社区聚类、语义检索、OSV 漏洞与 taint 安全分析、PR 调用路径差异与 CI 影响面检查、Konveyor Kantra 迁移规则，以及快照 diff 和 JSON/GraphML/Mermaid/Obsidian 导出；错误同样以结构化 JSON 返回。
适用场景: 在 Cursor、Claude、Codex 等编码智能体中回答架构与调用链问题、评估修改某符号的上下游影响、做 PR 结构审查与影响面门禁、跨语言代码库（Java、Python、TypeScript、C/C++ 等）的符号与关系检索、控制流/数据流追踪与克隆排查、漏洞与依赖检查、迁移规则检查。
项目形态: 可直接使用的工具
部署方式: 本地 CLI：提供 macOS/Linux 一键安装脚本、GitHub Releases 预编译包，或从源码用 Rust 1.85+ 构建；索引产物写入仓库的 .rgctl/ 目录，支持 rgctl update 增量更新与 rgctl serve --watch。
主要依赖: 源码构建需 Rust 1.85+；运行平台为 macOS、Linux、Windows（Releases），一键安装脚本覆盖 macOS/Linux；部分平台若 ort/ONNX 链接失败需加 --no-default-features。
使用限制: 材料称支持“14 种一级语言”但列举了 15 个语言徽章加 Markdown，具体范围以语言文档为准；CFG/PDG 与切片功能需以 discover --with-cfg 建索引；材料未说明语义检索所用模型、资源占用及 API 成本。
许可证: MIT
最近推送: 2026-10-22 05:15

官方入门项目文档核对 README 依据 ↗

资料检查：2026-10-22 07:00 · 卡片整理：2026-10-22 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证

职业应用

程序员

程序员可用 rgctl 为代码库建立知识图谱，查询调用者、传递影响范围（blast-radius）、控制流与数据流切片、克隆检测、社区聚类以及 PR 调用路径变化，并以紧凑 JSON 输出供 LLM 编程智能体使用，减少反复 grep 和读取整文件的 token 开销；还可将技能包安装到 Cursor、Claude、Codex 等编码智能体。

查看内容依据

索引一次后，可通过紧凑的 JSON 输出查询调用者、传递影响范围（blast-radius）、控制流与数据流切片、克隆检测、社区聚类以及 PR 调用路径变化，减少智能体反复用 grep 搜索整个代码库并读取整文件带来的 token 开销。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

SyntaxRAG：面向 AI 代理的本地代码检索 MCP 引擎

SyntaxRAG（SYNRAG）是一个本地代码搜索 MCP 引擎，通过 Tree-sitter 按函数、类、类型等 AST 结构切分代码，在 CPU 上用 FlashRank（TinyBERT）对 BM25 候选重排序，并构建依赖影响图。它提供搜索、文件大纲、仓库地图、影响范围分析、测试定位及受控编辑等工具，以减少 AI 代理定位代码时的 token 消耗；附带安装脚本、CLI、可选的变更监视服务和 Gemini 相关可选功能。

Brito：带代码知识图谱与可审核技能的终端编码智能体

Brito 是一个面向软件开发的编码智能体，提供命令行工具 brito-cli 和 macOS/Windows/Linux 桌面应用。它不依赖逐文件 grep 阅读，而是用 tree-sitter 增量索引构建代码知识图谱（符号、调用、导入），支持 TypeScript/JavaScript、Python、Svelte/Vue/Astro 组件及多种后端语言，可通过 graph_search、graph_callers、graph_impact 等工具快速回答“改这里会影响什么”。它还会保存记忆笔记，并在任务完成后反思生成项目技能，新技能先进入试用期，经多次成功使用后转正，涉及危险命令或修改已批准技能时需用户审批，并提供隐私检查（如拒绝密钥、curl | sh 等）与手动/自动编辑/计划/全允许等权限模式。支持 Anthropic API 或 Claude Code 订阅作为后端，也可接入 OpenAI 兼容端点，并可作为 MCP 服务器向其他客户端暴露图谱、记忆与技能。

book-to-skill：将技术书与文档转换为可按需加载的 Agent 技能

book-to-skill 是一个 Python 工具，能从技术书、内部文档、规范或研究资料中抽取结构（框架、决策规则、反模式、章节内容），生成符合 Agent Skills 开放标准的 SKILL.md 及章节、词汇表、模式与速查文件，写入跨 Agent 的技能目录。生成的技能可由 GitHub Copilot CLI、Amp、Codex、Claude Code 等宿主按需加载对应章节来回答问题，从而减少将整本书放入上下文带来的 Token 消耗。该仓库是上游的 Windows-first 维护型 fork，补充了繁体中文文档、Windows 开发与验收流程以及上游追踪机制。

mcptoon：统一管理 MCP 工具与 Agent 技能并压缩上下文的零依赖 CLI

mcptoon 是一个纯 Python 标准库实现的零依赖命令行工具，用于统一管理本机上的 MCP 服务器工具与 Agent 技能。它把工具描述和技能全文留在磁盘上，只向上下文注入紧凑的名称索引，按 README 的实测数据，255 个工具的描述从 71,929 tokens 降至 581 tokens；完整 schema 与技能文本可通过 inspect、retrieve 等命令按需取回，因此压缩是无损的。它还提供 17,000+ MCP 服务器的自然语言检索安装、统一的 call 调用入口、stdio 诊断、离线 BM25 技能与文档章节路由，并向 Claude Code、Cursor、Codex、Windsurf 等 103+ 客户端写入统一的连接配置。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。