skills.rest
chiragborse1
chiragborse1COMMUNITY
Explore all skills by this author →
Website𝕏@chiragborse1GitHub

session-logs

Search and analyze agent session JSONL logs to retrieve conversation context and compute metrics.

Updated Aug 27, 2026
Search Tags:#jq#ripgrep#jsonl#log-analysis#conversation-history#session-logs
One-click install
npx skills add https://github.com/chiragborse1/Kove --skill session-logs-chiragborse1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/chiragborse1/Kove/tree/main/skills/session-logs
Command: npx skills add https://github.com/chiragborse1/Kove --skill session-logs-chiragborse1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recover and inspect historical conversation context that is not present in active memory by searching append-only session JSONL files, enabling continuity across parent/older chats and audit of past interactions.

Core Features & Use Cases

  • Indexed session discovery: Locate sessions by date, provider, or filename using the sessions.json index and file timestamps.
  • Message extraction and filtering: Extract user or assistant text content, tool calls, and compute message counts or token metrics from JSONL records.
  • Cost and usage analysis: Aggregate per-session cost, produce daily summaries, and generate tool-usage breakdowns for billing or optimization.
  • Use Case: Investigate what a user asked in a previous chat, calculate the cost of a long-running session, or search across all agent sessions for a specific phrase.

Quick Start

Search the agent's session directory for the phrase billing and summarize matching conversations with timestamps and total cost.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search past conversation history in agent session logs?▼

You can search past conversation history in agent session logs by applying ripgrep to locate specific phrases and jq to extract matching messages with timestamps from JSONL files.

How do I calculate per-session cost from JSONL conversation logs?▼

Calculate per-session cost from JSONL conversation logs by using jq to aggregate token metrics and generate billing summaries across individual chat sessions.

Do I need jq and ripgrep to analyze session logs?▼

Yes, you need jq and ripgrep installed because these command-line tools are required to filter JSONL records and aggregate metrics from the local state directory.

What is the best way to locate earlier user messages across older chats?▼

The best way to locate earlier user messages across older chats is to query the sessions.json index by date or provider, then extract text content from the JSONL records.

Can I generate tool-usage breakdowns for past agent sessions?▼

Yes, you can generate tool-usage breakdowns for past agent sessions by applying jq to aggregate tool call records stored in the JSONL files and summarizing the results.

Related Skills

Explore More Software Engineering Skills→
fmoda3fmoda3
42

cc-history

Query and analyze Claude Code JSONL conversation history logs with jq.

Community
Intermediate
MicrockMicrock
322

Convex Agents Usage Tracking

Track LLM token usage and calculate costs for billing reports.

Community
Advanced
openaeonopenaeon
87

session-logs

Search and analyze OpenAEON session JSONL transcripts for historical context across multiple chats.

Community
Basic
brikkoAIbrikkoAI
1

session-logs

Retrieve and analyze historical AI conversations from JSONL session logs.

Official
Intermediate