Repolode
zzet

zzet/gortex

本地代码智能引擎,将多个代码仓库索引为知识图谱,通过 CLI、MCP 服务与 API 提供给 AI 编程助手和 IDE。

Star
2,012
Fork
194
未关闭 Issue
194
最近提交
前天

这是什么?

Gortex 使用 tree-sitter 解析源代码,构建持久化的知识图谱,记录函数、类、调用链、HTTP 路由以及跨服务的接口契约。图谱存储在本地 SQLite 中,可以同时覆盖多个代码仓库。AI 编程助手通过 MCP 工具查询图谱,只读取所需的符号和关系,而不是整个文件,项目称此举可将 token 用量降低至多 50 倍。

项目以单个静态二进制文件发布,支持 macOS、Linux 和 Windows,以后台守护进程运行,监听文件变化并增量更新索引。它内置基于 GloVe 模型的语义搜索,可选接入多种 LLM,并提供用于图谱可视化的 Web UI。`gortex init` 命令可为 Claude Code、Cursor、Codex CLI 等编程助手完成配置。

此外,它还支持 HTTP、gRPC、GraphQL 和消息主题等跨仓库 API 契约匹配,可对计划中的修改做影响分析,并通过 PR 审查命令标出影响范围与合并冲突。

核心功能

  • 01将 257 种语言和语法的代码索引为符号与调用关系图谱
  • 02提供 175 个可配置的 MCP 工具供 AI 编程助手调用
  • 03单个图谱可覆盖多个仓库,并支持跨仓库契约匹配
  • 04以单一二进制文件本地运行,附带后台守护进程与文件监听
  • 05内置语义搜索,并提供图谱可视化的 Web UI

适用场景

  • 在不读取整文件的前提下,为编程助手提供大型单体仓库的上下文
  • 在修改被多个服务共用的函数前,检查可能受影响的调用方
  • 追踪微服务之间的 HTTP、gRPC 或消息主题调用关系
  • 审查待合并的 PR,评估影响范围与合并冲突

快速上手

  1. 1

    运行 macOS 或 Linux 的官方安装脚本

  2. 2

    一次性机器设置(MCP、技能、斜杠命令)

    gortex install
  3. 3

    在后台启动守护进程

    gortex daemon start --detach
  4. 4

    将代码仓库添加到图谱中

    gortex track ~/projects/myapp

使用前须知

  • 从源码构建需要 Go 1.26 及以上版本,并启用 CGO。
  • 索引超大型代码仓库需要数 GB 内存,例如索引 Linux 内核时峰值堆内存约为 5 GB。

收录于专题

标签

常见问题

gortex 是什么?
本地代码智能引擎,将多个代码仓库索引为知识图谱,通过 CLI、MCP 服务与 API 提供给 AI 编程助手和 IDE。 Gortex 使用 tree-sitter 解析源代码,构建持久化的知识图谱,记录函数、类、调用链、HTTP 路由以及跨服务的接口契约。图谱存储在本地 SQLite 中,可以同时覆盖多个代码仓库。AI 编程助手通过 MCP 工具查询图谱,只读取所需的符号和关系,而不是整个文件,项目称此举可将 token 用量降低至多 50 倍。
gortex 可以免费使用吗?用的什么许可证?
gortex 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
gortex 还在维护吗?
活跃维护中。gortex 最近一次提交是在 2026年11月5日。
gortex 适合用来做什么?
在不读取整文件的前提下,为编程助手提供大型单体仓库的上下文 在修改被多个服务共用的函数前,检查可能受影响的调用方 追踪微服务之间的 HTTP、gRPC 或消息主题调用关系 审查待合并的 PR,评估影响范围与合并冲突
gortex 怎么安装和运行?
运行 macOS 或 Linux 的官方安装脚本 一次性机器设置(MCP、技能、斜杠命令): gortex install 在后台启动守护进程: gortex daemon start --detach 将代码仓库添加到图谱中: gortex track ~/projects/myapp
在哪里获取 gortex?
源代码和安装说明在 GitHub 上:https://github.com/zzet/gortex

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目