session-logs

Search and analyze JSONL conversation histories to extract user and assistant messages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze your complete conversation history stored in session JSONL files to recall prior context and support informed decisions.

Core Features & Use Cases

  • Index and browse sessions stored under ~/.crocbot/agents/<agentId>/sessions/ via sessions.json
  • Extract and review user and assistant messages from a chosen session
  • Filter conversations by date or keyword to quickly locate relevant discussions

Quick Start

Ask the session-logs skill to locate all user messages containing a keyword across a chosen session.

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 histories stored as JSONL files?

You can search past conversation histories by filtering JSONL session files under ~/.crocbot/agents/<agentId>/sessions/ by date or keyword to quickly locate and retrieve relevant prior context.

Can I extract specific user or assistant messages from a past session log?

Yes, you can extract and review specific user and assistant messages from a chosen session log by parsing the JSONL data to isolate the exact conversation turns you need.

Do I need jq and rg installed to analyze session JSONL data?

Yes, analyzing session JSONL data requires both jq and rg installed locally, as the skill relies on these command-line tools to parse, filter, and search the conversation histories.

What is the best way to filter conversation histories by date or keyword?

The best way to filter conversation histories by date or keyword is using jq and rg to query the local sessions.json index and the underlying JSONL session files for matching context.

How does indexing past sessions work with JSONL and jq?

Indexing past sessions works by reading the sessions.json file to browse available JSONL logs, then using jq to parse the structured conversation data and extract specific messages for review.

Why am I unable to find my previous session history in the local directory?

You may be unable to find previous session history if the JSONL files are not stored under the expected ~/.crocbot/agents/<agentId>/sessions/ directory, or if the sessions.json index is missing or outdated.