- name
- ccsinfo
- description
- Query and analyze Claude Code session data from a remote server. Use when asked to inspect Claude Code sessions, view conversation history, check tool calls, track tasks, search prompts, or view usage statistics. Requires CCSINFO_SERVER_URL to be set and a ccsinfo server running.
- metadata
- {"clawdbot":{"requires":{"env":["CCSINFO_SERVER_URL"],"bins":["ccsinfo"]},"install":[{"id":"script","kind":"script","command":"bash scripts/install.sh","bins":["ccsinfo"],"label":"Install ccsinfo CLI"}]}}
ccsinfo - Claude Code Session Info
Access and analyze Claude Code session data from a remote ccsinfo server running on the user's machine.
Server Repository: https://github.com/myk-org/ccsinfo
Requirements
1. Server Setup (on the machine with Claude Code data)
The ccsinfo server must be running on the machine that has Claude Code session data.
Install and run the server:
# 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 9999The server reads Claude Code session data from ~/.claude/projects/ and exposes it via REST API.
For full server documentation, see: https://github.com/myk-org/ccsinfo
2. Client Setup (where this skill runs)
The ccsinfo CLI tool must be installed. Check if installed:
which ccsinfoIf not installed, run the installation script:
bash scripts/install.sh3. Configuration
Set the CCSINFO_SERVER_URL environment variable to point to your server:
export CCSINFO_SERVER_URL=http://192.168.1.100:9999Add this to your shell profile (.bashrc, .zshrc, etc.) to persist across sessions.
Quick Start
All commands automatically connect to the remote server via $CCSINFO_SERVER_URL.
List recent sessions
ccsinfo sessions listShow session details (supports partial ID matching)
ccsinfo sessions show <session-id>View conversation messages
ccsinfo sessions messages <session-id>Search sessions by content
ccsinfo search sessions "search term"View global statistics
ccsinfo stats globalCommon Workflows
Inspect a specific session
- List sessions to find the ID:
ccsinfo sessions list- Show session details:
ccsinfo sessions show <id>- View messages:
ccsinfo sessions messages <id>- Check tool calls:
ccsinfo sessions tools <id>Find sessions by content
# Search across all sessions
ccsinfo search sessions "refactor"
# Search message content
ccsinfo search messages "fix bug"
# Search prompt history
ccsinfo search history "implement feature"Track tasks
# 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>View statistics and trends
# Overall usage stats
ccsinfo stats global
# Daily activity breakdown
ccsinfo stats daily
# Analyze trends over time
ccsinfo stats trendsWork with projects
# List all projects
ccsinfo projects list
# Show project details
ccsinfo projects show <project-id>
# Project statistics
ccsinfo projects stats <project-id>Output Formats
Most commands support --json for machine-readable output:
ccsinfo sessions list --json
ccsinfo stats global --jsonThis is useful for parsing results programmatically or filtering with jq.
Session ID Matching
Session IDs support partial matching - use the first few characters:
ccsinfo sessions show a1b2c3 # matches a1b2c3d4-e5f6-7890-abcd-ef1234567890Reference
For complete command reference, see cli-commands.md.
Troubleshooting
Check server connectivity
# Verify server URL is set
echo $CCSINFO_SERVER_URL
# Test connection (list sessions)
ccsinfo sessions listVerify installation
# Check if ccsinfo is installed
which ccsinfo
# Check version
ccsinfo --versionReinstall if needed
bash scripts/install.sh