How does this skill help with cost management?

It extracts usage metadata from the logs to calculate the total cost for individual sessions or provide a daily aggregate summary of expenses.

Where are the session logs stored?

Logs are stored as JSONL files in the ~/.clawdbot/agents/ directory under the specific agent's session folder.

Can I search for text across all my past sessions?

Yes, the skill provides specific commands to search across every session file in your local database for phrases or keywords.

Do I need special tools to use this skill?

Yes, this skill requires the 'jq' and 'rg' (ripgrep) command-line utilities to be installed on your system to parse and search JSON data.

What information is included in the logs?

Logs include message content, timestamps, message roles (user, assistant, tool), tool calls, and detailed token usage metadata.

Session Log Manager

Name: Session Log Manager
Author: xiaxingxiaowei1983

byxiaxingxiaowei1983

0•

Analytics & Monitoring

Enables deep searching and analysis of conversation history to retrieve historical context and monitor usage metrics.

The Session Log Manager skill provides a robust set of tools for navigating and analyzing your Claude session history stored in JSONL format. By leveraging jq and ripgrep (rg), it allows users to perform complex queries across past conversations, including searching for specific keywords, summarizing daily costs, and breaking down tool usage. This skill is essential for users who need to reference older parent conversations, audit agent performance, or track token consumption over time without manual searching.

Key Features

010 GitHub stars

02Granular filtering of user and assistant messages via jq

03Automated cost analysis and daily budget summaries

04Session indexing and metadata retrieval by date or size

05Deep search across all historical conversation logs using ripgrep

06Detailed tool usage breakdowns to track agent behavior

Use Cases

01Recalling specific context or instructions from a parent conversation several days old

02Debugging agent behavior by analyzing past tool calls and responses

03Auditing total token spend and cost per session for budget tracking

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xiaxingxiaowei1983/ai session-logs

For use in Claude.ai and ChatGPT