Why should I clone conversations before debugging?

Cloning preserves the original bug evidence and allows for multiple reproduction attempts and A/B testing without modifying the source data.

How do conversation dumps help with prompt optimization?

They export the full message history to JSON or HTML, allowing you to use tools like jq to analyze the prompt structure and iterate on improvements.

What is the benefit of the -p flag in this skill?

The -p flag allows you to test specific tasks and functionality non-interactively, making it faster to verify changes and automate tests.

Should I use release builds for debugging?

No, the skill recommends standard debug builds as they are faster to compile and provide necessary symbols for troubleshooting.

Can I use this skill for any CLI tool?

While the workflow principles are universal, the specific commands and patterns are optimized for the Forge CLI application.

CLI Debug & Testing Workflow

Name: CLI Debug & Testing Workflow
Author: Activer007

byActiver007

Security & Testing

Simplifies the debugging and extension of CLI applications through systematic build, test, and conversation cloning workflows.

About

The debug-cli skill provides a comprehensive framework for troubleshooting and enhancing command-line interfaces, specifically optimized for the code-forge application. It establishes a rigorous methodology for reproducing bugs safely by cloning conversations, verifying command documentation with automated help checks, and using non-interactive prompt testing. By integrating conversation dumping in both JSON and HTML formats, developers can perform deep-dive analyses into prompt structures and application behavior, ensuring that CLI modifications are stable and well-documented before deployment.

Key Features

Non-destructive bug reproduction via conversation cloning
Standardized debug build and documentation verification procedures
Prompt optimization workflows using jq and conversation exports
0 GitHub stars
Non-interactive testing patterns using the -p flag
Automated conversation dumping to JSON and HTML for deep analysis

Use Cases

Analyzing and optimizing AI-driven prompt structures in terminal applications
Verifying new CLI features and command-line options without interactive overhead
Fixing argument parsing bugs or command crashes in CLI tools

About

Key Features

Non-destructive bug reproduction via conversation cloning
Standardized debug build and documentation verification procedures
Prompt optimization workflows using jq and conversation exports
0 GitHub stars
Non-interactive testing patterns using the -p flag
Automated conversation dumping to JSON and HTML for deep analysis

Use Cases

Analyzing and optimizing AI-driven prompt structures in terminal applications
Verifying new CLI features and command-line options without interactive overhead
Fixing argument parsing bugs or command crashes in CLI tools