cli-debug-log-analysis

What problem does it solve?

Parse and analyze Ralph CLI debug logs (cli-debug.log) to extract subagent spans, tool call sequences, token consumption, context compaction events, and error patterns. Use this skill when you need to manually parse a cli-debug.log file — for example when the subagent-mapper's pre-extracted data is insufficient or missing, when debugging a specific subagent's behavior in detail, or when investigating infrastructure issues visible only in raw logs. Trigger on phrases like 'parse the debug log', 'extract subagent spans', 'analyze tool calls from the log', 'what happened in the cli-debug log', or 'dig into the raw log'.

Core Features & Use Cases

• Subagent span extraction: identify the start and end of each subagent invocation and pair them with the resolved model.
• Tool call sequencing: map function/tool calls within each subagent span to reconstruct the execution trace.
• Telemetry consolidation: capture token usage and context window metrics (e.g., context compaction events) for performance analysis.
• Debugging aids: provide targeted extraction recipes to investigate infrastructure issues, model fallbacks, or tool failures.

Quick Start

Analyze a cli-debug.log to map subagent spans, tool calls, and token usage for a given run.