Documentation
Guides, references, and tutorials for CLI Forge.
Guides
Getting Started with CLI Forge
Learn how to create your first CLI with CLI Forge
TypeScript Configuration
TypeScript setup and configuration for CLI Forge
Documentation Generation
Auto-generate documentation from your CLI definition
Middleware
Transform arguments and add context before command handlers run
Configuration Files
Load CLI arguments from JSON files and package.json
Validation and Constraints
Validate input with choices, conflicts, implications, strict mode, and custom validators
Testing
Test your CLI with the TestHarness, unit tests, and end-to-end strategies
Browser Usage
Using cli-forge in browser environments like playgrounds, documentation sites, and web-based tools
Comparison with Other Tools
How CLI Forge compares to yargs, commander, oclif, clipanion, cac, meow, citty, cleye, Effect CLI, gluegun, and Node.js util.parseArgs
Dependency Injection
Register providers with .provide() and inject them into handlers via getCommandContext()
Comparison
CLI Forge vs. yargs
Detailed comparison of CLI Forge and yargs — type inference, config files, middleware, and more.
CLI Forge vs. commander
Detailed comparison of CLI Forge and commander — type safety, option types, middleware, and more.
CLI Forge vs. oclif
Detailed comparison of CLI Forge and oclif — API style, type inference, plugin system, and distribution.
CLI Forge vs. clipanion
Detailed comparison of CLI Forge and clipanion — API patterns, middleware, state machine parsing, and more.
CLI Forge vs. cac
Detailed comparison of CLI Forge and cac — type safety, validation, middleware, and more.
CLI Forge vs. meow
Detailed comparison of CLI Forge and meow — help generation, subcommands, option types, and more.
CLI Forge vs. citty
Detailed comparison of CLI Forge and citty — option types, validation, middleware, and more.
CLI Forge vs. cleye
Detailed comparison of CLI Forge and cleye — middleware, config files, option types, and more.
CLI Forge vs. @effect/cli
Detailed comparison of CLI Forge and @effect/cli — API patterns, type safety, Effect integration, and more.
CLI Forge vs. gluegun
Detailed comparison of CLI Forge and gluegun — type safety, middleware, toolbox, templates, and more.
CLI Forge vs. util.parseArgs
Detailed comparison of CLI Forge and Node.js util.parseArgs — feature richness vs. zero-dependency simplicity.