Repolode
ix-infrastructure

ix-infrastructure/Ix

Ix 将代码仓库解析为持久化的符号、调用与导入关系图,供开发者和 AI 编程代理查询结构。

Star
1,097
Fork
82
未关闭 Issue
25
最近提交
昨天

这是什么?

Ix 是一款命令行工具,将代码库映射为由符号、调用、导入和包含关系组成的图谱。它使用 tree-sitter 解析仓库,并把结果存入本地后端,图谱在多次会话之间保持不变,无需每次通过搜索重新梳理。

通过 CLI 可以查询某个符号的作用、被谁调用、依赖什么,以及修改后会影响哪些部分。输出支持纯文本、JSON 和面向大模型的精简格式。内置的 MCP 服务器可把同一张图谱提供给 Claude Code、Codex、Cursor、VS Code 等支持 MCP 的客户端,`ix view` 则会打开名为 Compass 的可视化界面。

后端以 Docker 镜像形式运行,基于 ArangoDB 与记忆层。安装脚本会自动补齐缺失的 Node.js、ripgrep 和 Docker。预编译 CLI 覆盖 Apple Silicon macOS、Linux 与 Windows x86-64,Intel Mac 可通过 Homebrew 从源码构建。

核心功能

  • 01借助 tree-sitter 将仓库解析为符号、调用和导入关系。
  • 02在本地持久保存代码图谱,跨会话复用。
  • 03支持 explain、trace、impact、callers 等针对单个符号的查询。
  • 04提供 MCP 服务器,并可自动注册到多款 AI 客户端。
  • 05支持 27 种编程语言以及多种配置与数据格式。

适用场景

  • 快速熟悉一个陌生的代码库。
  • 在修改函数前评估可能受影响的范围。
  • 让编程代理获取结构化上下文,而不必粘贴整个文件。
  • 通过依赖关系排名找出核心模块。

快速上手

  1. 1

    运行 README 中的官方安装脚本(macOS/Linux)

  2. 2

    解析一个代码仓库

    ix map .
  3. 3

    将你的 AI 客户端注册到 MCP 服务器

    ix mcp install

使用前须知

  • 需要 Docker 和 Docker Compose 来运行本地 ArangoDB 后端。
  • 安装脚本通过管道直接执行远程脚本,Intel Mac 需要通过 Homebrew 从源码构建。

标签

常见问题

Ix 是什么?
Ix 将代码仓库解析为持久化的符号、调用与导入关系图,供开发者和 AI 编程代理查询结构。 Ix 是一款命令行工具,将代码库映射为由符号、调用、导入和包含关系组成的图谱。它使用 tree-sitter 解析仓库,并把结果存入本地后端,图谱在多次会话之间保持不变,无需每次通过搜索重新梳理。
Ix 可以免费使用吗?用的什么许可证?
Ix 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
Ix 还在维护吗?
活跃维护中。Ix 最近一次提交是在 2026年10月21日。
Ix 适合用来做什么?
快速熟悉一个陌生的代码库。 在修改函数前评估可能受影响的范围。 让编程代理获取结构化上下文,而不必粘贴整个文件。 通过依赖关系排名找出核心模块。
Ix 怎么安装和运行?
运行 README 中的官方安装脚本(macOS/Linux) 解析一个代码仓库: ix map . 将你的 AI 客户端注册到 MCP 服务器: ix mcp install
在哪里获取 Ix?
源代码和安装说明在 GitHub 上:https://github.com/ix-infrastructure/Ix

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

相关项目