| name | actions-debugging-cli |
| description | GitHub Actions CI/CD debugging via CLI — look up errors, diagnose workflows, and search 65+ known issues. Use when agent sees "Actions error", "CI failed", "workflow broken", "debug Actions", "why did my build fail", or any CI/CD debugging. Requires: npx @htekdev/actions-debugger (zero install).
|
Actions Debugging CLI
Quick Start
No installation needed. Run via npx:
npx @htekdev/actions-debugger lookup "your error message here"
Commands
Lookup an error message
npx @htekdev/actions-debugger lookup "<exact error text from logs>"
Returns: matching known errors with root cause, fix, and prevention steps.
Search by keyword
npx @htekdev/actions-debugger search "<keyword>" [--category <cat>] [--severity <sev>]
Categories: yaml-syntax, silent-failures, runner-environment, permissions-auth,
caching-artifacts, triggers, concurrency-timing, known-unsolved
Diagnose a workflow file
npx @htekdev/actions-debugger diagnose .github/workflows/<file>.yml
Returns: static analysis findings with severity and fixes.
Get fix suggestions
npx @htekdev/actions-debugger suggest-fix "<describe the problem>"
List all categories
npx @htekdev/actions-debugger categories
Workflow for Agents
- Extract the error message from CI logs (exact text, not paraphrased)
- Run
lookup with the exact error text
