cli-scaffold

CLI Scaffold Command

Scaffold a new Rust CLI application with best practices, proper structure, and all necessary dependencies configured.

Arguments

• $1 - Project name (required)
• $2 - Project type: "simple", "subcommands", or "plugin" (optional, default: "simple")

Usage

# Create a simple single-command CLI
/cli-scaffold my-cli simple

# Create a CLI with subcommands
/cli-scaffold my-cli subcommands

# Create a CLI with plugin architecture
/cli-scaffold my-cli plugin

What Gets Created

The scaffold creates a complete Rust CLI project with:

Dependencies

• clap (v4+) with derive feature for argument parsing
• anyhow for error handling in application code
• thiserror for library error types
• miette for beautiful error messages with diagnostics
• tracing + tracing-subscriber for structured logging
• config for configuration management
• directories for XDG directory support
• serde for configuration serialization

Project Structure

my-cli/
├── Cargo.toml
├── src/
│   ├── main.rs          # Entry point
│   ├── lib.rs           # Library interface
│   ├── cli.rs           # CLI definitions
│   ├── commands/        # Command implementations
│   │   └── mod.rs
│   ├── config.rs        # Configuration management
│   ├── error.rs         # Error types
│   └── logging.rs       # Logging setup
├── tests/
│   └── integration.rs   # Integration tests
├── config/
│   └── default.toml     # Default configuration
└── README.md

Features

1. Clean architecture - Library-first design, thin CLI wrapper
2. Error handling - miette for beautiful diagnostics, structured errors
3. Logging - Tracing with verbosity levels (-v, -vv, -vvv)
4. Configuration - TOML config with precedence (defaults < file < env < CLI)
5. Testing - Integration tests with assert_cmd pre-configured
6. Shell completions - Built-in completion generation
7. Cross-platform - Works on Windows, macOS, Linux