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

Ready to run

npx skills add https://github.com/lanej/dotfiles --skill claude-tail

💬 Prompt for ChatGPT / Claude Chat▼

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.