介绍
# ccsinfo - Claude Code Session Info
从用户机器上运行的远程 ccsinfo 服务器访问和分析 Claude Code 会话数据。
**服务器仓库**：https://github.com/myk-org/ccsinfo
## 要求
### 1. 服务器设置（在包含 Claude Code 数据的机器上）
ccsinfo 服务器必须运行在拥有 Claude Code 会话数据的机器上。
安装并运行服务器： ```bash # 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/projects/` 读取 Claude Code 会话数据，并通过 REST API 暴露这些数据。
完整的服务器文档，请参阅：https://github.com/myk-org/ccsinfo
### 2. 客户端设置（在此技能运行的位置）
必须安装 `ccsinfo` CLI 工具。检查是否已安装：
```bash which ccsinfo ```
如果未安装，请运行安装脚本：
```bash bash scripts/install.sh ```
### 3. 配置
设置 `CCSINFO_SERVER_URL` 环境变量以指向您的服务器：
```bash export CCSINFO_SERVER_URL=http://192.168.1.100:9999 ```
将其添加到您的 shell 配置文件（`.bashrc`、`.zshrc` 等）中，以便在会话之间持久保存。
## 快速开始
所有命令都会通过 `$CCSINFO_SERVER_URL` 自动连接到远程服务器。
### 列出最近的会话 ```bash ccsinfo sessions list ```
### 显示会话详情（支持部分 ID 匹配） ```bash ccsinfo sessions show <session-id> ```
### 查看对话消息 ```bash ccsinfo sessions messages <session-id> ```
### 按内容搜索会话 ```bash ccsinfo search sessions "search term" ```
### 查看全局统计信息 ```bash 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> ```
### 按内容查找会话
```bash # Search across all sessions ccsinfo search sessions "refactor"
# Search message content ccsinfo search messages "fix bug"
# Search prompt history ccsinfo search history "implement feature" ```
### 跟踪任务
```bash # 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> ```
### 查看统计信息和趋势
```bash # Overall usage stats ccsinfo stats global
# Daily activity breakdown ccsinfo stats daily
# Analyze trends over time ccsinfo stats trends ```
### 使用项目
```bash # List all projects ccsinfo projects list
# Show project details ccsinfo projects show <project-id>
# Project statistics ccsinfo projects stats <project-id> ```
## 输出格式
大多数命令支持 `--json` 以输出机器可读格式：
```bash ccsinfo sessions list --json ccsinfo stats global --json ```
这对于以编程方式解析结果或使用 `jq` 进行过滤非常有用。
## 会话 ID 匹配
会话 ID 支持部分匹配 - 使用前几个字符：
```bash ccsinfo sessions show a1b2c3 # matches a1b2c3d4-e5f6-7890-abcd-ef1234567890 ```
## 参考
完整的命令参考，请参阅 [cli-commands.md](references/cli-commands.md)。
## 故障排除
### 检查服务器连接 ```bash # Verify server URL is set echo $CCSINFO_SERVER_URL
# Test connection (list sessions) ccsinfo sessions list ```
### 验证安装 ```bash # Check if ccsinfo is installed which ccsinfo
# Check version ccsinfo --version ```
### 如需重新安装 ```bash bash scripts/install.sh ```