ccsinfo - Claude 代码会话信息

访问并分析来自用户机器上运行的远程 ccsinfo 服务器的 Claude 代码会话数据。

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

要求

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

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

安装并运行服务器：

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

# Start the server (accessible on LAN)
ccsinfo serve --host 0.0.0.0 --port 9999

服务器从以下位置读取 Claude 代码会话数据：~/.claude/projects/并通过 REST API 将其暴露出来。

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

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

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

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 <session-id>

查看对话消息

ccsinfo sessions messages <session-id>

按内容搜索会话

ccsinfo search sessions "search term"

查看全局统计信息

ccsinfo stats global

常见工作流程

检查特定会话

1. 列出会话以查找ID：

   ccsinfo sessions list
   

2. 显示会话详情：

   ccsinfo sessions show <id>
   

3. 查看消息：

   ccsinfo sessions messages <id>
   

4. 检查工具调用：

   ccsinfo sessions tools <id>
   

按内容查找会话

# Search across all sessions
ccsinfo search sessions "refactor"

# Search message content
ccsinfo search messages "fix bug"

# Search prompt history
ccsinfo search history "implement feature"

追踪任务

# Show all pending tasks
ccsinfo tasks pending

# List tasks for a session
ccsinfo tasks list -s <session-id>

# Show specific task details
ccsinfo tasks show <task-id> -s <session-id>

查看统计数据和趋势

# Overall usage stats
ccsinfo stats global

# Daily activity breakdown
ccsinfo stats daily

# Analyze trends over time
ccsinfo stats trends

处理项目

# List all projects
ccsinfo projects list

# Show project details
ccsinfo projects show <project-id>

# Project statistics
ccsinfo projects stats <project-id>

输出格式

大多数命令支持--json格式以实现机器可读的输出：

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

这对于通过程序解析结果或使用jq进行过滤非常有用

。

会话ID匹配

ccsinfo sessions show a1b2c3  # matches a1b2c3d4-e5f6-7890-abcd-ef1234567890

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

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

。

故障排除

# Verify server URL is set
echo $CCSINFO_SERVER_URL

# Test connection (list sessions)
ccsinfo sessions list

检查服务器连接

# Check if ccsinfo is installed
which ccsinfo

# Check version
ccsinfo --version

验证安装

bash scripts/install.sh