Cc Codex History Viewer — Development skill for Claude Code
本地 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
**本地、只读地浏览 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 历史 | |
session_id、text、ts |
| 当前会话 | |
完整事件流 |
Related Skills
Cc History Viewer
本地 Claude Code 历史 Prompt 与对话可视化工具 · Local desktop viewer for Claude Code prompt & conversation history
Agent Trail
Local web viewer for Claude Code and Codex CLI session history across multiple profiles.
Claude Compaction Viewer
View and analyze Claude Code conversation history and compaction events with a TUI and CLI tool for clear sess
Agent Conv CLI
Read and continue your local Claude Code / Codex CLI / Cursor conversation history from the terminal (chats/re
Prompt Sensei
Local-first prompt coach for Claude Code and Codex that improves prompts, observes prompting habits, and analy
Claude Code Session Recovery
Diagnose and repair Claude Desktop session metadata bugs on Windows and Mac — missing conversation history, lo
Related Agents
Conversation Historian
Use when analyzing Claude Code conversation history, finding past sessions by topic, tracing how implementatio
Story Generator
Use this agent when you need to generate user stories with acceptance criteria from various inputs like git di
History Reader
Reads Claude conversation history for a target date and synthesizes it into timesheet entries for the skill to