Skip to content
CAI
Software that uses CAICheck a score

urfave/cli

65.8

Adequate · 13 November 2026

7k

lines of production code

Go

primary language

8

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.