session-logs

Analyze Lemon JSONL session logs with jq filters.

130|16|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/z80dev/lemon --skill session-logs-z80dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logs
Source: https://github.com/z80dev/lemon/tree/main/apps/lemon_skills/priv/builtin_skills/session-logs
Command: npx skills add https://github.com/z80dev/lemon --skill session-logs-z80dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Lemon users often need to review older conversations to understand context, so this skill provides fast access to historical session data stored as per-session JSONL logs.

Core Features & Use Cases

  • List sessions by date and size
  • Extract user messages from a session
  • Search for keywords in assistant responses
  • Get total cost and daily cost summaries

Quick Start

Use the session-logs skill to search and analyze your Lemon sessions with jq.

Frequently Asked Questions about session-logs

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

FAQPage Schema
How do I search through Lemon conversation history stored as JSONL session logs?

You search Lemon conversation history by applying jq-based filters to the per-session JSONL files stored in the ~/.lemon/agent/sessions directory. This allows you to quickly locate and analyze older conversations by inspecting user or assistant messages and timestamps.

What is the best way to extract user messages and timestamps from Lemon session logs?

The best way to extract user messages and timestamps from Lemon session logs is by running jq queries against the JSONL files. This method parses the structured conversation data to isolate specific message types and associated metadata across sessions.

Can I calculate total API costs and daily cost summaries from Lemon conversation history?

You can calculate total and daily cost summaries from Lemon conversation history by using jq to sum the cost fields recorded in the JSONL session logs. This provides a quick overview of expenses aggregated by date or across all stored sessions.

Do I need jq installed to list Lemon sessions by date and analyze file sizes?

Yes, you need jq installed to list Lemon sessions by date and analyze file sizes, as the skill relies on jq-based filters to query the JSONL data. It operates directly on the session files stored in the ~/.lemon/agent/sessions directory.

How does searching assistant responses for keywords in JSONL session logs work?

Searching assistant responses for keywords works by using jq to filter the JSONL session log entries and match specific text strings within the assistant message fields. This allows you to quickly find historical conversation context across your stored Lemon sessions.

What are the limitations when analyzing older Lemon conversations stored locally?

The primary limitation is that analysis is restricted to local JSONL files located in the ~/.lemon/agent/sessions directory. You can only query and extract data from sessions that have been previously logged and stored on your local machine.