Interactive CLI tool to browse and export Claude Code conversations
npm install @vamdawn/cconvo交互式 CLI 工具,用于浏览和导出 Claude Code 本地保存的对话记录。
- 扫描并列出所有项目和对话
- 支持导出为 Markdown、JSON、HTML 格式
- 交互式菜单界面,支持项目浏览和搜索
- 统计视图,显示 Token 使用量和文件大小
- 支持子代理 (subagent) 对话
``bash`
npm install -g @vamdawn/cconvo
安装后启用 Shell 补全:
`bash`
cconvo completion:setup
`bash`
cconvo
进入交互式界面,可以:
- 浏览项目列表
- 搜索对话
- 预览对话内容
- 选择导出格式和选项
`bash列出所有项目和对话
cconvo list
导出格式
| 格式 | 说明 |
|------|------|
| Markdown | 适合阅读和二次编辑,支持折叠显示思考过程和工具调用 |
| JSON | 完整数据导出,保留所有元信息 |
| HTML | 带暗色主题样式的可视化页面,支持交互式展开/折叠 |
数据源
工具读取
~/.claude/projects 目录下的对话数据:`
~/.claude/
├── history.jsonl # 全局对话历史
└── projects/
└── -Users-xxx-Repository-xxx/ # 项目目录
├── {sessionId}.jsonl # 主对话文件
└── {sessionId}/
└── subagents/
└── agent-{id}.jsonl # 子代理对话
`Shell 补全
`bash
安装补全
cconvo completion:setup卸载补全
cconvo completion:uninstall
``查看 开发指南
MIT