用户手册

欢迎使用 Jieli

Jieli 把你的 AI 编程对话实时同步到云端,变成可搜索、可分享、可跨 Agent 接力的工程上下文。本手册帮你用满它。

1为什么是 Jieli

Jieli 是「接力」的拼音。换工具、换会话时,上一棒的完整上下文交到下一棒手里,任务不掉链子地继续——这就是「接力」,也是 Jieli 名字的由来。

Jieli 是 AI 编程对话的云端同步 + 浏览 / 搜索 / 分享平台。装上插件后,你在 Claude Code、Codex、Amp 里的会话会自动同步上来,默认私密,只有你能看到。

  • 多来源:Claude Code、Codex、Amp 统一汇聚在一个地方。
  • 可搜索:把散落在各处的对话变成可全文检索的工程记忆。
  • 可分享:一键生成只读链接,把某次排障过程分享给同事。
  • 可接力:换工具、换会话时,带着完整上下文无缝继续。
Jieli 与插件配合使用。Jieli 保存同步上来的会话记录,原始会话仍保留在你本地;每条对话都能导出 md / json,随时可自行留底。

2快速开始

  • 用 GitHub 登录 jieli.app,创建账户。
  • 在设置里复制你的访问令牌(API key)。
  • 在你的编程工具里安装 Jieli 插件(见下一节)。
  • 之后会话会通过插件 hooks 自动同步,无需手动操作。

3安装插件

Claude Code

在终端里运行:

claude plugin marketplace add jieliapp/plugins
claude plugin install jieli@jieliapp

Codex

在终端里运行:

codex plugin marketplace add jieliapp/plugins
codex plugin add jieli@jieliapp

安装后配置 API key:把密钥粘进对话让 agent 写入,写到 ~/.config/jieli/settings.json, 或导出环境变量。

export JIELI_API_KEY="<在 jieli.app 复制的密钥>"

4浏览与搜索

在对话列表里可以全文搜索,并按来源、仓库、标签、可见性、是否归档过滤,快速定位某次对话。

插件也能让 agent 直接搜索你的历史对话——给它一个关键词、文件名或仓库线索,它会调用 Jieli 的搜索接口召回相关线程作为上下文。

GET /plugin/threads?search=<关键词>&provider=claude_code&sort=updated

5续接与跨 Agent 接力

这是 Jieli 的核心:一次对话的上下文不必困在原会话里,可以带着它换会话、甚至换工具继续。

同工具续接

在对话详情页点「在 CLI 中打开」,按来源生成续接命令,回到原工具接着干:

claude --resume <session>
codex resume <session>
amp threads continue <thread>

跨 Agent 接力(handoff)

handoff skill 会从当前对话里抽取关键信息和相关文件,生成一段交接上下文,并附上 Jieli 线程 ID。把这段交接内容(或直接把线程链接)交给一个新的 agent——可以是另一个工具——它就能无缝接着干。

新 agent 拿到 Jieli 线程链接后,jieli skill 会自动触发,读取该线程的 markdown 导出,把完整上下文加载进来:

jieli-read-thread <thread_id> --truncate-tool-results --max-chars 12000
你只需要粘贴一条 /threads/T-… 链接,新会话就能拿到上一段工作的目标、决策、改过的文件和待办——不必把上下文重新讲一遍。

Commit trailer(对 Code Review 尤其有用)

Claude Code 创建的提交会自动带上一行 trailer,指向产生这次改动的 Jieli 线程:

Jieli-Thread: https://jieli.app/threads/T-...

Code Review 时,审查者点开这行链接,就能看到这次提交背后的完整推理过程——为什么这么改、试过哪些方案、验证了什么——而不只是看到最终 diff。

6分享对话

每条对话默认私密,只有你能看到。需要分享时,把可见性改为「链接可见」,任何拿到链接的人都能只读查看;复制分享链接发出去即可。

7导出与归档

每条对话都能导出为 Markdown 或 JSON。不再需要的对话可以归档,从默认列表里收起来。

删除是不可逆操作,Jieli 无法恢复。删除前请先用导出 md / json 留底。

8订阅计划

Free 保留最多 3 万条消息,浏览 / 搜索 / 分享 / 导出全部可用;Pro 提升到 50 万条。完整对比见订阅计划页