debug-headless
CommunityDebug AI CLI in headless mode.
Authornicsuzor
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill enables debugging of AI command-line interfaces (like Claude Code or Gemini CLI) in a non-interactive, automated environment, ensuring full capture of all output and debug logs.
Core Features & Use Cases
- Headless Execution: Run AI CLI commands without manual interaction.
- Full Output Capture: Records all standard output, standard error, and debug logs.
- Transcript Generation: Converts raw session logs into human-readable Markdown transcripts for analysis.
- Use Case: Debugging an AI agent's automated workflow that failed mid-execution by reviewing the complete, captured session transcript to pinpoint the exact error.
Quick Start
Run the debug-headless skill to execute a Claude Code command with a specific prompt and capture its output.
Dependency Matrix
Required Modules
uv
Components
scriptsreferences
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: debug-headless Download link: https://github.com/nicsuzor/academicOps/archive/main.zip#debug-headless Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.