log-lister

List and filter logs by type, status, and date with JSON output.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fractary/claude-plugins --skill log-lister
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log-lister
Source: https://github.com/fractary/claude-plugins/tree/main/plugins/logs/skills/log-lister
Command: npx skills add https://github.com/fractary/claude-plugins --skill log-lister

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Lists and filters logs across types (session, build, deployment, etc.) with frontmatter-driven metadata.

Core Features & Use Cases

  • Discover logs via type and location
  • Filter by status, date, and type
  • Return structured JSON for automation

Quick Start

List all session logs within a date range and filter by status.

Frequently Asked Questions about log-lister

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

FAQPage Schema
How do I list and filter logs by type and date range?

log-lister discovers logs across types (session, build, deployment, etc.) and filters by date, status, and type using frontmatter-driven metadata. Query with optional date range and status filters to retrieve targeted log subsets as structured JSON for automation.

Can I parse logs with frontmatter metadata for structured retrieval?

Yes. log-lister parses frontmatter from logs to extract metadata, enabling type-aware filtering and enrichment with retention context. Output is returned in structured JSON format suitable for downstream processing and automation.

What's the best way to organize and retrieve logs across multiple types?

log-lister centralizes log discovery by supporting multi-format outputs, optional grouping, and pagination across session, build, and deployment logs. Sort by date and apply status or type filters to retrieve organized subsets without modifying source files.

Do I need bash and jq to use log-lister?

Yes. log-lister requires bash and jq as dependencies. These tools enable type-aware filtering, frontmatter parsing, and JSON output generation for log retrieval and enrichment.

Can log-lister handle read-only log listing with sorting and pagination?

Yes. log-lister performs read-only listing with date-based sorting, optional grouping, and pagination. It enriches results with retention context and supports multi-format outputs for flexible log retrieval workflows.