bun-cli

What problem does it solve?

This Skill provides a structured approach to building production-grade CLI tools with Bun. It covers argument parsing patterns, dual output formats (Markdown for humans and JSON for machines), error handling, subcommand design, and testing practices. Use when you want fast, predictable CLIs with strong UX and measurable quality.

Core Features & Use Cases

• Argument parsing: Handles --flag value, --flag=value, and boolean flags with consistent semantics.
• Output formats: Supports Markdown (human-readable) and JSON (machine-consumable) outputs.
• Error handling & commands: Clear error messages, usage patterns, and support for subcommands.
• Reference patterns: Includes patterns and references to guide CLI design, testing, and quality checks.

Quick Start

Create a minimal Bun CLI template and run simple commands to verify behavior:

• bun run src/cli.ts config --format json
• bun run src/cli.ts help