urfave/cli
65.8
Adequate · 13 November 2026
7k
lines of production code
Go
primary language
8
measurements over time
What this system is
Features
Add shell completion scripts for Bash, Zsh, Fish, and PowerShell
Users can now enable command-line autocompletion for the application in Bash, Zsh, Fish, and PowerShell environments. The new scripts in the autocomplete directory generate completions dynamically by invoking the application's \--generate-shell-completion\ flag, supporting both subcommands and flags with optional descriptions where available.
autocomplete · high confidence
Added example programs for binary size checking
New example programs have been added to the examples directory to serve as benchmarks for binary size analysis. This includes a minimal CLI example using the urfave/cli/v3 library and a basic hello-world program, both located in their respective subdirectories within examples/.
examples · high confidence
Initial project scaffolding and configuration
This change introduces the foundational project structure for the urfave/cli v3 library. It adds essential configuration files including a .gitignore, a .golangci.yaml linter configuration (enabling gofumpt, makezero, and misspell), and a Makefile to streamline build, test, and documentation workflows. It also includes the MIT LICENSE, a CODE\_OF\_CONDUCT.md, and an updated README.md that documents the library's features and links to the new v3 documentation site.
(repo-wide) · high confidence
New build script with gfmrun integration and CLI commands
The \scripts/build.go\ file introduces a new Go-based build tool that provides CLI commands for project maintenance, including \vet\, \test\, \lint\, and \gfmrun\. It integrates \gfmrun\ (version v1.3.3) for validating markdown files, with support for walking directories and installing the tool from source. The script also includes commands for managing MkDocs documentation, checking binary sizes, and handling version diffs.
scripts · high confidence
Test coverage
Updated test fixtures for v3 documentation and shell completion generation
The testdata directory has been refreshed with new expected output files to validate the v3 documentation and completion features. This includes new markdown and man-page templates (e.g., \expected-doc-full.md\, \expected-doc-full.man\) that now include command descriptions, usage text, and global options, alongside tabular markdown variants (\expected-tabular-markdown-full.md\) that present flags in tables with environment variables. Additionally, new fish shell completion scripts (\expected-fish-full.fish\) are added to verify command and flag completion logic, and the \godoc-v3.x.txt\ baseline has been updated to reflect the current v3 API surface.
testdata · high confidence
Dependencies
Introduce Go modules and update dependencies
The project now uses Go modules, declaring a minimum Go version of 1.22 in the root go.mod and introducing a separate go.mod for the docs subdirectory (requiring Go 1.23.2). Dependencies have been updated: the root module requires github.com/stretchr/testify v1.12.1 and go.yaml.in/yaml/v3 v3.0.5, while the docs module requires github.com/urfave/cli/v3 v3.1.1, github.com/urfave/cli-altsrc/v3 v3.0.1, github.com/BurntSushi/toml v1.5.0, github.com/stretchr/testify v1.11.1, and gopkg.in/yaml.v3 v3.0.1.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 71 → 66 (-4.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 85 → 79 (-6.0)
- Architecture 99 → 98 (-0.8)
- Maturity 58 → 54 (-4.6)
- Readiness 79 → 79 (+0.0)
- Security 80 → 71 (-8.2)
Resolved (4)
- Documentation: no installation or build instructions (README.md)
- Off-boarding risk: anonymized user #1
- main.GfmrunActionFunc (cognitive 45) (scripts/build.go)
- main.GfmrunActionFunc (cyclomatic 27) (scripts/build.go)
New (18)
- Duplicated block (5 lines × 2) (help_notemplate.go)
- Duplicated block (8 lines × 2) (command_parse.go)
- Duplicated block (8 lines × 2) (flag_int.go)
- Edited copies of one member (3 members, 10+ corresponding lines) (flag_float.go)
- Edited copy of a member (11 corresponding lines) (command.go)
- Edited copy of a member (15 corresponding lines) (category.go)
- Edited copy of a member (7 corresponding lines) (category.go)
- Edited copy of a member (9 corresponding lines) (flag_map_impl.go)
- Edited copy of a member (9 corresponding lines) (flag_number_slice.go)
- MethodTooLong: Command.setupDefaults (command_setup.go)
- Off-boarding risk: anonymized user #1
- Repeated repair: fish.go (fish.go)
- Repeated repair: flag_ext.go (flag_ext.go)
- Repeated repair: flag_slice_base.go (flag_slice_base.go)
- TooManyMethods: FlagBase (flag_impl.go)
- cli.helpCommandAction (cognitive 16) (help.go)
- cli.prepareFishFlags (cognitive 21) (fish.go)
- cli.printFlagSuggestions (cognitive 22) (help.go)
Changes since last survey
- 60 commits — 25 feature/other, 35 fixes
By area
- (root) — 29 commits
- (repo) — 27 commits
- docs/v3 — 2 commits
- autocomplete/bash_autocomplete — 1 commit
- scripts/build.go — 1 commit
Notable commits
- fix: Merge pull request #2482 from Plastic-time/fix/nil-collection-deserialization-20261020
- fix: Merge pull request #2485 from kimjooyoon/fix/completion-short-groups
- fix: Merge pull request #2491 from tkr109/fix/flag-state-on-rerun
- fix: Merge pull request #2493 from vidigoat/fix/categorized-command-usage-indent
- fix: Merge pull request #2494 from vidigoat/fix/flag-hint-hooks
- fix: Merge pull request #2495 from vidigoat/fix/fish-completion-app-name-prefix
- fix: Merge pull request #2498 from vidigoat/fix/fish-script-first-line-usage
- fix: Merge pull request #2499 from vidigoat/fix/short-group-missing-argument-dash
- fix: Merge pull request #2500 from vidigoat/fix/fish-takes-file-all-flag-types
- fix: Merge pull request #2501 from vidigoat/fix/complete-commands-after-finished-flag
- fix: Merge pull request #2502 from vidigoat/fix/complete-no-flag-after-its-alias
- fix: Merge pull request #2506 from vidigoat/fix/fish-persistent-flags
- fix: Merge pull request #2509 from yxshee/fix/docs-v3-mismatches
- fix: Merge pull request #2511 from Rohilalala/fix/wrap-runes
- fix: Merge pull request #2512 from nk-batman21/fix/completion-help-command-name
- fix: fix: check mutually exclusive groups after dispatching to a subcommand
- fix: fix: complete the arguments passed to Run at the root command
- fix: fix: count runes, not bytes, when wrapping help text
- fix: fix: don't drop fish completions that start with the app name
- fix: fix: don't let a Go flag hide a flag of the same name
- …and 40 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
urfave/cli was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit d5c06cb04479eeacbbb9378ea26261b6be516320 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-f3449e6eb431.