A batteries-included template with structured errors, config management, agent backend, CI/CD pipelines, and automated releases — so you can focus on your logic, not your scaffolding.
Get Started View on GitHubClap argument parsing, tokio async runtime, and tracing observability wired up from day one.
Structured, contextual error handling with snafu — no manual Display or Error impls.
Run instantly via npx — no Rust toolchain required. Pre-built binaries for macOS and Linux.
GitHub Actions with lint, test, and release pipelines preconfigured and working out of the box.
JSON stdout, actionable errors, example-driven help — designed for AI agents to operate reliably.
Conventional commits, changelogs, and version bumps handled automatically by release-plz.
AI agents operate your CLI programmatically. This template bakes in the rararulab agent-friendly CLI standards so every generated project is agent-ready from day one.
Structured output on stdout for machine parsing. Human-readable logs on stderr. Never mix formats.
Every error includes a suggestion field so agents can self-correct without human intervention.
Every parameter passable via flags. No stdin prompts without a flag equivalent. Agents cannot handle dynamic prompts.
Every subcommand's --help includes runnable examples. Agents pattern-match better than they parse prose.
Agents retry frequently. Create operations return success if the resource already exists — no duplicate side effects.
Destructive commands support --dry-run. Interactive confirmations have --yes to bypass. Safe automation by default.
# Success: structured JSON on stdout
$ my-cli deploy --env staging
{"ok": true, "action": "deploy", "deploy_id": "d-123"}
# Error: actionable suggestion included
$ my-cli deploy
{"ok": false, "error": "missing --env", "suggestion": "add --env staging or --env prod"}$ npx @your-org/your-project --help$ cargo generate rararulab/cli-template
$ cd my-awesome-cli
$ cargo run -- --helpnpx — no Rust requiredcargo generate