session-logs

Search and analyze past session logs in JSONL files using jq and rg.

3.1k|368|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/openocta/openocta --skill session-logs-openocta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/openocta/openocta/tree/main/src/embed/skills/session-logs
Command: npx skills add https://github.com/openocta/openocta --skill session-logs-openocta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, rg, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to search and analyze your past conversation history, which is crucial when a user refers to older or parent conversations that are not currently in the active memory.

Core Features & Use Cases

  • Session Log Access: Directly access and query session logs stored in JSONL files.
  • Historical Context Retrieval: Find information from previous interactions to provide a complete understanding of the conversation flow.
  • Use Case: If a user asks, "What did we decide about the Q3 marketing budget last week?", this skill can search through the ~/.openocta/agents/<agentId>/sessions/ directory to find the relevant conversation and extract the decision.

Quick Start

Search for sessions containing the keyword "budget" from the previous week.

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 for a specific topic?

Yes, you can retrieve historical context from parent discussions by searching session logs. By using rg and jq to parse JSONL files in the sessions directory, you can extract specific decisions or topics referenced from older conversations.

How do I find a decision from a previous session using jq?

To extract historical context, you parse JSONL session logs with jq and rg. This filters structured conversation data by keywords and retrieves the relevant text from past interactions without needing to load the entire history into active memory.

Do I need jq and rg installed to search session logs?

Yes, installing jq and rg is required. This Skill depends on these command-line tools to parse and search the JSONL session logs located in the ~/.openocta/agents/ directory to retrieve historical conversation context.

What is the best way to analyze JSONL conversation logs?

The best way to analyze JSONL conversation logs is by using jq and rg to search and parse the files. This approach allows you to directly query historical session data and extract specific context from past user interactions.

Where are my past conversation session logs stored?

Your past conversation session logs are stored as JSONL files in the ~/.openocta/agents/<agentId>/sessions/ directory. This Skill requires access to this specific path to search and retrieve your historical context.

Can I search historical interactions that are not in active memory?

Yes, you can search historical interactions not in active memory. By parsing JSONL session logs with jq and rg, you can retrieve older conversation context that has rolled out of your current session window.