CLI UX Linter

CLI UX Linter

Live Analysis

Paste your --help output to score discoverability, flags, examples, error guidance, and readability.

Overall Score
0
Discoverability
0
Flags & Options
0
Examples
0
Lines: 0
Commands: 0
Flags: 0
Examples: 0

No help text provided

high

Paste your --help output or CLI docs so the linter can evaluate UX quality.

(empty)
mycli --help output

Need scaffolding too? Generate a CLI from OpenAPI.

What This Tool Does

CLI UX Linter is built for deterministic developer and agent workflows.

Audit your CLI --help output for discoverability, flag consistency, examples, and error guidance.

Use How to Use for execution steps and FAQ for constraints, policies, and edge cases.

Last updated:

This tool is provided as-is for convenience. Output should be verified before use in any production or critical context.

Agent Invocation

Best Path For Builders

Browser workflow

Runs instantly in the browser with private local processing and copy/export-ready output.

Browser Workflow

This tool is optimized for instant in-browser execution with local data handling. Run it here and copy/export the output directly.

/cli-ux-linter/

For automation planning, fetch the canonical contract at /api/tool/cli-ux-linter.json.

How to Use CLI UX Linter

  1. 1

    Paste your CLI help output

    Copy your command's --help output (or docs snippet) into the editor. Include Usage, Commands, and Options sections for accurate linting.

  2. 2

    Set optional command context

    Add the command name (for example, mycli) so the linter can detect naming mismatches and context gaps.

  3. 3

    Run the UX audit instantly

    The tool scores discoverability, flag consistency, examples, error guidance, output clarity, and accessibility in real time.

  4. 4

    Apply quick fixes

    Review issue-by-issue before/after suggestions and prioritize high-severity fixes first to improve first-run user success.

  5. 5

    Export markdown report

    Copy the generated markdown report into your PR description or release checklist to track CLI UX quality over time.

Frequently Asked Questions

What does CLI UX Linter check?
It evaluates help output quality across discoverability, flag consistency, examples, error guidance, output clarity, and accessibility, then returns concrete fixes with before/after suggestions.
Can I lint docs instead of --help output?
Yes. You can paste CLI docs or README command sections. Results are best when your input includes Usage, Commands, and Options blocks.
Does this tool run my command?
No. It is text-only analysis in your browser. No command execution and no server-side processing.
Can I share lint results with my team?
Yes. Use the Copy Markdown action to export a report for pull requests, issue trackers, or release checklists.
How is this different from shellcheck?
shellcheck lints shell scripts. CLI UX Linter focuses on user-facing command ergonomics and help text clarity.