analyze-log-files

Analyze Log Files

When to Use

• When user asks to "analyze log.txt", "read the log file", "process logs", "check the logs"
• When dealing with any .log or log-related files that may contain ANSI escape sequences
• When terminal output has been captured to a file and needs analysis
• When log files appear garbled or contain escape sequence artifacts

Why This Matters

Log files captured from terminal sessions often contain ANSI escape sequences for:

• Colors (e.g., \x1b[31m for red)
• Cursor movements
• Text formatting (bold, underline)
• Screen clearing commands

These sequences make logs difficult to:

1. Read in plain text editors
2. Search with grep/ripgrep
3. Process with text analysis tools
4. Analyze accurately by LLMs

Instructions

Step 1: Strip ANSI Escape Sequences

Before analyzing any log file, first strip the ANSI sequences using ansifilter:

ansifilter -i log.txt -o /tmp/clean_log.txt

For other log file names, adjust accordingly:

ansifilter -i <input_file> -o /tmp/clean_log.txt

Step 2: Analyze the Clean Log

Read and analyze /tmp/clean_log.txt instead of the original file:

# Use the Read tool on /tmp/clean_log.txt

Step 3: Report Findings

When reporting findings to the user:

• Reference line numbers from the clean log
• Quote relevant sections
• Summarize errors, warnings, or patterns found

Common Log File Locations

• log.txt - General purpose log in project root
• target/ - Cargo build logs
• /tmp/*.log - Temporary logs

Example Workflow

User: "Can you analyze log.txt and tell me what's wrong?"

1. Run: ansifilter -i log.txt -o /tmp/clean_log.txt
2. Read: /tmp/clean_log.txt
3. Analyze the content for errors, warnings, patterns
4. Report findings to user

Troubleshooting

If ansifilter is not installed:

# Ubuntu/Debian
sudo apt-get install ansifilter

# macOS
brew install ansifilter

# Or run bootstrap.sh to install all dependencies
./bootstrap.sh

Related Skills

• check-code-quality - For checking Rust code quality (may generate logs)
• analyze-performance - For performance analysis (generates flamegraph data)

Related Commands

• /analyze-logs - Explicitly invokes this skill