本地运行 / 零配置 / 9 个 Agent

你和 AI 写过的每一次对话，都还在。

CodeSesh 扫描九种 AI 编码 Agent 的本地会话，把分散的历史收进同一个索引：按项目组织、结构化搜索、逐条回放。会话内容与索引留在本机，无需账号、云同步或会话遥测。

npx codesesh

http://localhost:4521

读取会话

01 / Overviewapps/web / dashboard

打开就知道这周花在哪儿了

会话、消息、Token、成本与最近活跃都来自同一个本地索引。切换时间窗口，概览同步重算。

切换时间范围，观察整块面板同步重算

Dashboard

Sessions: 212; +18.4% 30.3/day
Messages: 32,764; +12.1% 154.5/session
Tokens: 1.58B; +9.7% Cache hit 61%
Cost: $84.20; +7.2% $18.40 estimated
Last activity: 2h; webapp / Claude Code

Daily Activity212 sessions / last 7 days

Apr 17
Apr 18
Apr 19
Apr 20
Apr 21
Apr 22
Apr 23

Agent Distribution

5 agents / 212 sessions

Claude Code67%142 / 67.0%
Codex18.4%39 / 18.4%
OpenCode8.5%18 / 8.5%
Kimi5.2%11 / 5.2%
Cursor0.9%2 / 0.9%

02 / Project treeapps/web / project timeline

会话回到它该在的项目里

按仓库和项目身份归组，子 Agent 会话保留在父会话下，消息、Token 与成本按层级汇总。

展开带有 sub 标记的会话，查看子 Agent 记录

webapp

96 sessions / 4 agents / /projects/webapp

APR 23, 2026 / THURSDAY

10:22

Implement onboarding wizard flowClaude Code / 84 msgs / 412K tok / 3 sub-sessions3 sub$1.86 incl. sub

10:26Generate step validation schema22 msgs / 96K tok
10:41Write WelcomeStep component tests17 msgs / 71K tok
11:03Audit a11y on the wizard stepper9 msgs / 38K tok

09:48

Refactor query building for readabilityCodex / 41 msgs / 188K tok$0.74

08:15

Fix webhook signature verification bugOpenCode / 29 msgs / 104K tok / 1 sub-session1 sub$0.41 incl. sub

08:31Reproduce the HMAC mismatch locally11 msgs / 34K tok

07:02

Tune session list virtualizationCursor / 18 msgs / 63K tok$0.22

03 / Replayapps/web / session detail

一次任务的完整路径逐条还原

消息、工具调用和文件变更按发生顺序呈现，类型过滤与文件追踪帮助你快速定位关键上下文。

展开工具调用查看输出，也可以从 TOC 隐藏消息类型

USER10:22:13
The current query builder is hard to follow. Refactor it into composable helpers and document the intent of each step.
AGENT10:22:18gpt-5.4
I will split the builder into focused functions and keep its behavior intact.
edit_filesrc/db/queryBuilder.tsEDITED+128 ~~-46~~
@@ buildQuery() - const parts = []; - return appendFilters(parts, filters); + const clauses = buildClauses(filters); + return clauses.filter(Boolean).join(" AND ");
bashpnpm test:unitSUCCESS
148 passed0 failed / 2.34s
AGENT10:24:31
Updated the builder, added types and focused comments, and kept behavior intact.
writesrc/db/queryBuilder.spec.ts+86 lines

发现、组织、找回、复盘。四步之后，历史才真正能用。

CodeSesh 围绕真实的 AI 编码协作循环组织能力。

发现

把不同 Agent 留下的本地会话统一纳入索引。

零配置启动
运行一条命令，自动扫描文件系统里的受支持 Agent 会话。
统一时间线
九种 Agent 的历史会话进入同一个界面。
实时刷新
本地会话变更自动进入索引，界面无需重启。

组织

让会话回到项目、任务和工程语境里。

项目与嵌套会话树
按仓库归组，并将子 Agent 会话保留在父会话下。
智能标签
自动识别修复、重构、功能、测试、文档与规划等工作。
会话别名
给重要会话一个易记名称，并在搜索与收藏中沿用。

找回

把过去的判断、路径和上下文带回当前任务。

结构化全局搜索
搜索标题、消息、工具输出和文件路径，再按项目、标签与工具筛选。
文件活动索引
从一个文件反查读取或修改过它的相关会话。
键盘导航
切换视图、聚焦搜索和移动分组，全程不离键盘。

复盘

还原一次任务从问题到结果的完整过程。

完整会话回放
消息、工具调用和推理步骤按发生顺序保留。
成本与 Token 可见
并列查看 Token、缓存命中、记录成本与按模型估算。
本地 SQLite 索引
一个本地数据库支撑快速恢复、检索与 schema 迁移。

覆盖本地AI 编码工具链

每种 Agent 通过 core 适配器接入同一个会话、项目、搜索和文件活动索引。

Claude Code
Cursor
Kimi
Kimi-Code
Codex
Grok
Pi
OpenCode
ZCode

常见问题

关于 CodeSesh 的定位、安装方式、数据边界和大型历史。

CodeSesh 是什么？

CodeSesh 是一个本地开发者工具，用来发现、聚合、搜索和回放 AI 编码会话历史。它把 Claude Code、Cursor、Kimi、Kimi-Code、Codex、Grok、Pi、OpenCode 和 ZCode 的本地记录整理成按项目组织的工程记忆层。

CodeSesh 会上传本地 AI 会话数据吗？

不会上传会话数据。CodeSesh 在本机使用 SQLite 索引，并通过 localhost 上的 Web UI 浏览历史。会话内容、文件路径、Token 统计和成本记录留在本机；产品不要求账号、云同步或会话遥测。

如何安装和启动 CodeSesh？

在终端运行 npx codesesh。CodeSesh 会扫描受支持的本地 AI 编码会话，并在 http://localhost:4521 打开 Web UI；如果默认端口被占用，它会尝试下一个可用端口。发布版需要 Node.js 22 或更高版本。

历史会话很多时，CodeSesh 如何保持流畅？

首次扫描会持久化回填进度，中断后可以继续。后续启动从本地 SQLite 缓存恢复，文件监听只增量更新发生变化的会话；长会话的消息列表按视口虚拟化，避免一次渲染全部内容。

现在就把历史找回来

开源、免费，会话数据留在本机。一条命令即可开始建立可搜索的 AI 编码工程记忆。

npx codesesh

在 GitHub 上查看