skills.rest
lanej
lanejCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

claude-tail

Analyze Claude Code session logs with filtering and real-time following.

40|12|Updated Oct 17, 2011
Search Tags:#monitoring#logs#log-analysis#colorful#claude-tail
One-click install
npx skills add https://github.com/lanej/dotfiles --skill claude-tail
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-tail
Source: https://github.com/lanej/dotfiles/tree/main/claude/skills/claude-tail
Command: npx skills add https://github.com/lanej/dotfiles --skill claude-tail

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides guidance for viewing, filtering, and analyzing Claude Code session logs with colorized output and real-time following.

Core Features & Use Cases

  • Real-time following: tail-like follow mode for live logs.
  • Filtering: by event type, tool, time range, and errors.
  • Display modes: compact, verbose, stats, and tools-only views.
  • Time-based queries: filter by after/before timestamps.
  • Pattern watching: watch patterns of log files or directories.

Quick Start

Example: view a recent Claude session log: claude-tail ~/.claude/sessions/2024-01-15-session.jsonl

Frequently Asked Questions about claude-tail

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

FAQPage Schema
How do I analyze Claude Code session logs with filtering and colorized output?▼

claude-tail analyzes Claude Code session logs by parsing JSONL files with colorized display and real-time following. It filters by event type, tool, time range, and errors across compact, verbose, stats, and tools-only display modes to identify events, anomalies, and tool usage patterns in development and debugging workflows.

Can I view live Claude session logs as they happen?▼

Yes, claude-tail supports tail-like follow mode for real-time tailing of Claude Code session logs, allowing you to watch log files or directories as new events stream in with colorized syntax highlighting.

What filtering options are available for Claude session logs?▼

claude-tail filters session logs by event type, tool name, time range (after/before timestamps), and errors. You can combine multiple filters to focus on specific tool usage, anomalies, or events within a defined time window.

Do I need special setup to parse Claude Code session logs?▼

No special prerequisites are required. claude-tail works directly with Claude Code session logs stored as JSONL files, typically located in ~/.claude/sessions/, without additional dependencies or environment configuration.

What display modes does claude-tail offer for viewing logs?▼

claude-tail provides four display modes: compact view for high-density output, verbose view for detailed event information, stats mode for aggregate metrics, and tools-only mode to isolate tool usage events.

Can I search logs by timestamp?▼

Yes, claude-tail supports time-based queries using after/before timestamp filters, enabling you to narrow log analysis to specific time ranges within your Claude Code sessions.

Related Skills

Explore More Data & Analytics Skills→
prince-khannaprince-khanna
1

view-team-session

Generate an interactive HTML viewer for Claude Code session logs from JSONL files.

Community
Intermediate
timbuchingertimbuchinger
1

loki-troubleshoot

Craft efficient Grafana Loki LogQL queries for debugging logs.

Community
Basic
jgwilljgwill
1

jsonl-chronicle-extractor

Extract regex-matching narrative blocks from JSONL message content.

Community
Basic
matteotittamatteotitta
29

why-slow

Diagnose performance bottlenecks in Claude Code sessions from process logs and MCP health.

Community
Intermediate