ljtn/epiq

这是什么？

核心功能

• 01以只追加的事件日志保存工单，并通过 Git 同步。
• 02回放看板历史，查看每次变更的时间和操作者。
• 03通过 Epiq-Ref 行或标题前缀将提交关联到工单，并在工单中查看代码差异。
• 04提供终端界面和浏览器界面，二者基于同一套引擎。
• 05提供 MCP 服务器，方便 AI 智能体读取和更新工单。

适用场景

• 在代码仓库内追踪问题，无需单独注册 SaaS 服务。
• 回看智能体在无人值守期间完成了哪些工作。
• 离线处理工单，之后通过 Git 同步变更。
• 将代码变更及其差异直接关联到对应工单。

快速上手

1. 1

   使用 README 中的官方安装脚本安装二进制文件

2. 2

   或通过 npm 安装

   npm install --global epiq
3. 3

   验证安装

   epiq --version
4. 4

   在 Git 仓库中运行 Epiq 以启动设置向导

   epiq

使用前须知

• !需要在 Git 仓库中使用，同步依赖你现有的 git 凭据。

收录于专题

标签

常见问题

epiq 是什么？

基于 Git 的自托管问题追踪工具，以事件日志保存工单，可回放看板随时间的变化。 Epiq 是一个自托管的问题追踪工具，工单数据不放在托管服务里，而是与代码仓库一起保存。看板状态以只追加、不可修改的事件日志形式存储，通过 Git 进行版本管理和同步，离线也能使用，需要时执行同步即可。

epiq 可以免费使用吗？用的什么许可证？

epiq 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

epiq 还在维护吗？

活跃维护中。epiq 最近一次提交是在 2026年10月21日。

epiq 适合用来做什么？

在代码仓库内追踪问题，无需单独注册 SaaS 服务。 回看智能体在无人值守期间完成了哪些工作。 离线处理工单，之后通过 Git 同步变更。 将代码变更及其差异直接关联到对应工单。

epiq 怎么安装和运行？

使用 README 中的官方安装脚本安装二进制文件 或通过 npm 安装: npm install --global epiq 验证安装: epiq --version 在 Git 仓库中运行 Epiq 以启动设置向导: epiq

在哪里获取 epiq？

源代码和安装说明在 GitHub 上：https://github.com/ljtn/epiq