名称： ccsinfo
描述： 从远程服务器查询和分析 Claude Code 会话数据。当需要检查 Claude Code 会话、查看对话历史、检查工具调用、跟踪任务、搜索提示词或查看使用统计时使用。需要设置 CCSINFO_SERVER_URL 并运行 ccsinfo 服务器。
元数据： {"clawdbot":{"requires":{"env":["CCSINFO_SERVER_URL"],"bins":["ccsinfo"]},"install":[{"id":"script","kind":"script","command":"bash scripts/install.sh","bins":["ccsinfo"],"label":"安装 ccsinfo CLI"}]}}

ccsinfo - Claude Code 会话信息

从运行在用户机器上的远程 ccsinfo 服务器访问和分析 Claude Code 会话数据。

服务器仓库: https://github.com/myk-org/ccsinfo

要求

1. 服务器设置（在拥有 Claude Code 数据的机器上）

ccsinfo 服务器必须运行在拥有 Claude Code 会话数据的机器上。

安装并运行服务器：

# 安装 ccsinfo
uv tool install git+https://github.com/myk-org/ccsinfo.git

# 启动服务器（在局域网内可访问）
ccsinfo serve --host 0.0.0.0 --port 9999

服务器从 ~/.claude/projects/ 读取 Claude Code 会话数据，并通过 REST API 暴露数据。

完整的服务器文档，请参阅：https://github.com/myk-org/ccsinfo

2. 客户端设置（运行此技能的位置）

必须安装 ccsinfo CLI 工具。检查是否已安装：

which ccsinfo

如果未安装，运行安装脚本：

bash scripts/install.sh

3. 配置

设置 CCSINFO_SERVER_URL 环境变量指向你的服务器：

export CCSINFO_SERVER_URL=http://192.168.1.100:9999

将此行添加到你的 shell 配置文件（.bashrc、.zshrc 等）中，以便在会话间持久化。

快速开始

所有命令都会通过 $CCSINFO_SERVER_URL 自动连接到远程服务器。

列出最近会话

ccsinfo sessions list

显示会话详情（支持部分 ID 匹配）

ccsinfo sessions show <会话-id>

查看对话消息

ccsinfo sessions messages <会话-id>

按内容搜索会话

ccsinfo search sessions "搜索词"

查看全局统计

ccsinfo stats global

常用工作流

检查特定会话

1. 列出会话以查找 ID：
   bash ccsinfo sessions list

2. 显示会话详情：
   bash ccsinfo sessions show <id>

3. 查看消息：
   bash ccsinfo sessions messages <id>

4. 检查工具调用：
   bash ccsinfo sessions tools <id>

按内容查找会话

# 在所有会话中搜索
ccsinfo search sessions "重构"

# 搜索消息内容
ccsinfo search messages "修复bug"

# 搜索提示词历史
ccsinfo search history "实现功能"

跟踪任务

# 显示所有待处理任务
ccsinfo tasks pending

# 列出会话的任务
ccsinfo tasks list -s <会话-id>

# 显示特定任务详情
ccsinfo tasks show <任务-id> -s <会话-id>

查看统计与趋势

# 总体使用统计
ccsinfo stats global

# 每日活动细分
ccsinfo stats daily

# 分析时间趋势
ccsinfo stats trends

处理项目

# 列出所有项目
ccsinfo projects list

# 显示项目详情
ccsinfo projects show <项目-id>

# 项目统计
ccsinfo projects stats <项目-id>

输出格式

大多数命令支持 --json 参数以生成机器可读的输出：

ccsinfo sessions list --json
ccsinfo stats global --json

这对于程序化解析结果或使用 jq 过滤非常有用。

会话 ID 匹配

会话 ID 支持部分匹配——使用前几个字符即可：

ccsinfo sessions show a1b2c3  # 匹配 a1b2c3d4-e5f6-7890-abcd-ef1234567890

参考

完整的命令参考，请参阅 cli-commands.md。

故障排除

检查服务器连接

# 验证服务器 URL 是否已设置
echo $CCSINFO_SERVER_URL

# 测试连接（列出会话）
ccsinfo sessions list

验证安装

# 检查 ccsinfo 是否已安装
which ccsinfo

# 检查版本
ccsinfo --version

如需重新安装

bash scripts/install.sh