session-logs

Search and analyze historical session conversations stored in JSONL logs.

2.5k|423|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/Bitterbot-AI/bitterbot-desktop --skill session-logs-bitterbot-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/Bitterbot-AI/bitterbot-desktop/tree/main/skills/session-logs
Command: npx skills add https://github.com/Bitterbot-AI/bitterbot-desktop --skill session-logs-bitterbot-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search and analyze historical session conversations across session logs stored as JSONL files to help recall prior context.

Core Features & Use Cases

  • Per-session access: Read and index individual sessions from ~/.bitterbot/agents/<agentId>/sessions/ to retrieve relevant context.
  • Cross-session search: Query across all sessions to surface prior user messages and assistant responses.
  • Context restoration: Reconstruct conversation history to support memory or follow-up questions.

Quick Start

Locate a specific session and summarize the user’s messages from that 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 historical session conversations stored in JSONL logs?

Search historical session conversations in JSONL logs by applying jq queries to filter and extract prior user messages and assistant responses from local session transcripts. This surfaces relevant context from past interactions for improved recall.

Can I query across multiple session histories to find prior context?

Cross-session search queries across multiple session histories to surface prior user messages and assistant responses. It indexes individual JSONL session transcripts from the local sessions directory to reconstruct conversation context.

Do I need jq to analyze session logs from the conversations directory?

jq is required to analyze session logs from the local conversations directory, and rg is used for advanced text search. Local access to the agent sessions directory containing JSONL transcripts is also necessary.

What's the best way to restore conversation context from past session transcripts?

Restore conversation context from past session transcripts by searching and analyzing historical JSONL session logs. This reconstructs conversation history to support memory and follow-up questions across per-session or cross-session queries.

Does session log analysis work for retrieving messages from a single specific session?

Session log analysis works for retrieving messages from a single specific session by reading and indexing individual JSONL transcripts from the local sessions directory. This per-session access retrieves relevant context for targeted recall.

Why use jq for parsing JSONL conversation histories instead of other text search tools?

jq parses JSONL conversation histories by structurally filtering JSON fields to extract specific user messages and assistant responses, whereas rg provides advanced text search across raw session content. Both tools operate together on local session transcripts.