ccsinfo – OpenClaw Skill

---

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.

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 9999

The 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 ccsinfo

If not installed, run the installation script:

bash scripts/install.sh

3. Configuration

Set the CCSINFO_SERVER_URL environment variable to point to your server:

export CCSINFO_SERVER_URL=http://192.168.1.100:9999

Add 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 list

Show 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 global

Common Workflows

Inspect a specific session

1. List sessions to find the ID:

   ccsinfo sessions list
   

2. Show session details:

   ccsinfo sessions show <id>
   

3. View messages:

   ccsinfo sessions messages <id>
   

4. 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 trends

Work 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 --json

This 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-ef1234567890

Reference

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 list

Verify installation

# Check if ccsinfo is installed
which ccsinfo

# Check version
ccsinfo --version

Reinstall if needed

bash scripts/install.sh

ccsinfo Skill

A Moltbot skill for querying and analyzing Claude Code session data from a remote ccsinfo server.

Installation

On the Server (where Claude Code runs)

Run the ccsinfo server:

ccsinfo serve --host 0.0.0.0 --port 9999

On the Client (where Moltbot runs)

1. Set the server URL in your environment or config:

   export CCSINFO_SERVER_URL=http://192.168.10.241:9999
   

2. Install the skill by placing it in your skills directory

3. Install the CLI tool (first time only):

   cd skills/ccsinfo
   bash scripts/install.sh
   

Usage

Once configured, simply ask the agent questions like:

• "Show me my recent Claude Code sessions"
• "What's in session 933fcc44?"
• "Search my Claude sessions for 'refactor'"
• "Show me pending tasks"
• "What are my Claude Code usage stats?"

The agent will automatically use the ccsinfo CLI to query your remote server.

Manual CLI Usage

You can also use the CLI directly:

# List sessions
ccsinfo sessions list

# Show session details
ccsinfo sessions show 933fcc44

# View messages
ccsinfo sessions messages 933fcc44

# Search
ccsinfo search sessions "keyword"

# Stats
ccsinfo stats global

Files

• SKILL.md - Main skill instructions
• scripts/install.sh - Installs ccsinfo CLI via uv
• scripts/ccs.sh - Wrapper script (optional)
• references/cli-commands.md - Complete CLI reference

Package

The skill is packaged as:

• ccsinfo.skill.tar.gz - Compressed archive for distribution

Requirements

• uv package manager (for installation)
• CCSINFO_SERVER_URL environment variable
• Network access to the ccsinfo server