log-searcher

Search local and archived logs with keywords, patterns, and filters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Unified search across local and archived logs with type-aware filtering and contextual results.

Core Features & Use Cases

  • Hybrid search across local and archived stores
  • Contextual results with source metadata
  • Support for regex and multi-filter queries

Quick Start

Search for a keyword across local and archived logs and view matched contexts.

Frequently Asked Questions about log-searcher

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

FAQPage Schema
How do I search across local and archived logs at the same time?

Log search across local and archived logs enables hybrid queries that check recent logs locally for speed while searching historical archives comprehensively. The Skill handles both scopes in a single query, automatically ranking results by relevance and annotating whether each match came from local or archived sources.

Can I use regex patterns and multiple filters to find specific log entries?

Yes. Log search supports regex patterns and multi-filter queries to narrow results across session, build, deployment, debug, test, audit, operational, and untyped logs. Matches return with surrounding context, making it easier to understand what caused an issue.

What log types can I search with this tool?

Log search covers eight log types: session, build, deployment, debug, test, audit, operational, and untyped logs. This breadth lets you locate relevant entries regardless of which system or process generated them.

Does log search work with grep and jq for advanced filtering?

Yes. Log search relies on bash, grep, and jq as dependencies, so you can combine it with these tools for advanced filtering, transformation, and structured output of log data.

How are search results ranked and limited?

Results are ranked by relevance and enforced against a maximum results limit to keep output manageable. Each match includes source metadata (local or archived) and archive details, helping you prioritize investigation.