session-logs

Search and analyze session JSONL files with jq.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/czue/clawdbot --skill session-logs-czue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/czue/clawdbot/tree/main/skills/session-logs
Command: npx skills add https://github.com/czue/clawdbot --skill session-logs-czue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly search and analyze your conversation history stored in session JSONL files, enabling fast recall, auditing, and insights from past interactions.

Core Features & Use Cases

  • Locate sessions by date, size, and provider from the sessions index.
  • Extract user or assistant messages from per-session .jsonl files for review or reporting.
  • Summarize costs, timestamps, and activity across sessions to track usage and trends.

Quick Start

Query the session history with jq to retrieve the latest user messages from ~/.clawdbot/agents/main/sessions/.

Frequently Asked Questions about session-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and extract messages from session JSONL files?

You can search and extract messages from session JSONL files by using jq to parse the data stored in your Clawdbot session history directory, filtering for specific user or assistant message fields.

How do I analyze token costs across past AI conversation sessions?

To analyze token costs across past AI conversation sessions, you parse the session JSONL files with jq to summarize cost data, timestamps, and activity metrics tracked within your Clawdbot session history.

What is the best way to locate historical chat sessions by date and size?

The best way to locate historical chat sessions by date and size is to query the sessions index file, which stores metadata allowing you to filter and locate specific past interactions.

Do I need jq installed to parse JSONL conversation logs?

Yes, you need jq installed to parse JSONL conversation logs, because this Skill relies on jq to query and extract structured data from the session history files located in your local directory.

Can I compute usage trends from JSONL session logs without a database?

Yes, you can compute usage trends from JSONL session logs without a database by using jq to directly query the local session files and aggregate cost, timestamp, and activity data.

Why am I unable to find my past Clawdbot session history?

You are unable to find your past Clawdbot session history if the required JSONL files and the sessions index do not exist at the expected local directory path, which this Skill requires to function.