XZL-CODE

Cc Codex History Viewer — Development skill for Claude Code

Development community

本地 Claude Code 历史 Prompt 与对话可视化工具 · Local desktop viewer for Claude Code prompt & conversation history.

How to install Cc Codex History Viewer

This entry records only its repository, not the path inside it, so there is no exact command to give. Open XZL-CODE/cc-codex-history-viewer and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Cc Codex History Viewer does

本地 Claude Code 历史 Prompt 与对话可视化工具 · Local desktop viewer for Claude Code prompt & conversation history.

Alternatives in Development

  • 09 Bygdebok Extraction — Local History Extraction 1.1k ★
  • Claude Usage — A local dashboard for tracking your Claude Code token usage, costs, and session history 864 ★
  • Coding Agent Session Search — Unified TUI and CLI to index and search your local coding agent session history across 11+ providers (Codex, C 708 ★

README

Coding Agent History Viewer

Coding Agent History Viewer

**本地、只读地浏览 Claude Code 与 OpenAI Codex 的 Prompt、会话和用量**

**A local, read-only viewer for Claude Code and OpenAI Codex history**

[简体中文](#简体中文) · [English](#english)


简体中文

Coding Agent History Viewer 是一个 Tauri 桌面应用。它在本机扫描 Claude Code 与 OpenAI Codex 的历史文件,按工作目录聚合 Prompt、会话、工具调用和 Token 用量。应用不联网,也不会把历史上传到任何服务。

功能

  • 在概览顶部按 Claude Code / Codex / 全部 筛选,默认选择“全部”并在本机持久化选择。
  • 按工作目录浏览项目、Prompt 和会话;“全部”模式下相同 cwd 合并为一个项目。
  • 查看最近 Prompt、全局搜索、文件夹内搜索、完整会话、Markdown、工具调用和思考内容。
  • 全文搜索会话内容:除 Prompt 外,还能按需扫描助手回复、思考摘要与工具调用参数,命中可跳转到对话中的具体消息并高亮关键词;不建索引、不落盘。
  • 对话详情:助手回复按 Markdown 渲染并高亮代码;Bash/Edit/Write/Read/TodoWrite 与 Codex apply_patch 等工具调用按语义展示(命令、行级 diff、补丁、清单);会话内查找、用户轮次大纲、全部展开/折叠、超长会话分批渲染。
  • 每会话 Token 与成本:会话列表可按最新 / 成本 / 消息数 / 时长排序;fork/resume 复制的调用只计入原会话,各会话之和等于全局总量。
  • 统计范围与活跃度日历:概览支持全部 / 近 7 天 / 近 30 天 / 本月 / 自定义区间,日历热力图补齐没有记录的日期。
  • Prompt、会话和导出内容保留 Claude Code 或 Codex 来源标识。
  • 统计每日活动、小时与星期分布、项目排行、模型、CLI 版本、Token、缓存命中率和估算成本。
  • 按文件 mtime 建立增量索引,并行扫描大历史库;JSONL 按行流式解析。索引在后台线程构建并实时显示进度,刷新默认只重解析变化的文件,全量重建放在设置中。
  • 搜索是独立路由,返回键可回到结果列表;记住窗口位置与尺寸;主题可跟随系统。
  • 任一产品的数据目录不存在时,仍可正常浏览另一个产品的数据。

快捷键

快捷键 作用
⌘/Ctrl + K 聚焦搜索框
Esc 清空搜索并返回上一页 / 关闭设置
⌘/Ctrl + R、F5 增量刷新本地数据
⌘/Ctrl + , 打开设置
⌘/Ctrl + F(对话详情内) 会话内查找,Enter / Shift+Enter 切换命中

数据路径

Claude Code

数据 默认路径 用途
Prompt 历史 ~/.claude/history.jsonl 输入框历史
完整会话 ~/.claude/projects/**/*.jsonl 用户/助手消息、工具调用和用量
会话元数据 ~/.claude/sessions/*.json CLI 版本等补充信息

设置中的 `historyFile`、`projectsDir`、`sessionsDir` 可分别覆盖路径;否则从 `claudeDataDir` 推导;仍未配置时使用 `~/.claude`。这些旧字段继续兼容已有 `settings.json`。

OpenAI Codex

数据 默认路径 用途
Prompt 历史 /history.jsonl session_idtextts
当前会话 /sessions/YYYY/MM/DD/rollout-*.jsonl 完整事件流