Cli Building

What it does

This skill, Cli Building, provides guidelines and recommendations for creating command-line interfaces (CLIs) using modern patterns and best practices. It focuses on streamlining development workflows by automating aspects of CLI creation and reducing repetitive coding tasks. The skill offers guidance on framework selection, command architecture, and output formatting to ensure robust and maintainable CLIs. It supports both TypeScript/JavaScript and Python environments.

When to use it

• Creating new CLI tools or commands from scratch.
• Adding new commands to existing projects that require a modern CLI approach.
• Developing interactive terminal applications with complex workflows.
• Building CLIs where asynchronous operations are central to functionality.
• When selecting a suitable CLI framework (e.g., stricli, oclif, cyclopts, typer).

Key capabilities

• Framework recommendations: Provides guidance on choosing appropriate frameworks for TypeScript/JavaScript (stricli, oclif) and Python (cyclopts, typer).
• Async-first design: Emphasizes asynchronous programming practices to avoid blocking operations.
• Composable commands: Encourages modularity and reusability through command composition patterns.
• Strategy pattern implementation: Suggests using the strategy pattern for branching workflows and task-based commands.
• Output formatting guidelines: Provides rules for clean output, including unicode symbols, color support (respecting NO_COLOR), and avoiding emojis.

Example prompts

• "Suggest a CLI framework suitable for an async-first Python project."
• "How can I structure my CLI commands to be more reusable?"
• "What are the best practices for formatting output in a command-line tool?"
• “Explain how to use the strategy pattern within a CLI application.”

Tips & gotchas

• The skill emphasizes an "async-first" approach, so familiarity with asynchronous programming concepts is beneficial.
• When using TypeScript/JavaScript, stricli is recommended for modern async-first CLIs, while oclif is suitable for more complex projects.
• Always respect the NO_COLOR environment variable when implementing color support in your CLI output.