Hive Hive
Sign in

fix(cli): show verbose flag in inspect help

GitHub issue · Closed

Metadata
Source
tuist/tuist #11385
Updated
Jun 24, 2026
Domains
CLI
Details

What changed

  • Added a shared LoggingOptions ParsableArguments type that declares the --verbose flag for help rendering.
  • Attached the option group to tuist inspect and the inspect subcommands, including the hidden deprecated implicit-imports and redundant-imports routes.
  • Declared the logging option after command-specific options so --verbose renders next to --help.

Why

tuist inspect dependencies --verbose already worked because Tuist handles global logging flags before command execution, but the inspect command family did not declare the flag in ArgumentParser. As a result, tuist inspect --help and tuist inspect dependencies --help omitted --verbose, which made the supported logging path hard to discover when investigating slow graph loading.

Root cause

The verbose flag was supported by Tuist’s outer command processing, but not represented in the inspect command definitions that ArgumentParser uses to render command-specific help.

Example help output

$ tuist inspect dependencies --help
OVERVIEW: Inspects implicit and redundant dependencies in Tuist projects,
failing when issues are found.
USAGE: tuist inspect dependencies [--path <path>] [--only <only> ...] [--verbose]
OPTIONS:
-p, --path <path> The path to the directory that contains the project.
(env: TUIST_INSPECT_DEPENDENCIES_PATH)
--only <only> Run only specified checks. Can be repeated. Default:
implicit, redundant. (env:
TUIST_INSPECT_DEPENDENCIES_ONLY)
implicit - implicit, redundant
redundant - implicit, redundant
--verbose Display verbose logs.
-h, --help Show help information.

Validation

  • swiftformat --lint on the touched inspect command files
  • swiftlint lint --quiet on the touched inspect command files
  • tuist install --force-resolved-versions
  • tuist generate tuist ProjectDescription --no-open
  • xcodebuild build -workspace Tuist.xcworkspace -scheme tuist -derivedDataPath /private/tmp/tuist-help-dd CODE_SIGNING_ALLOWED=NO CODE_SIGNING_REQUIRED=NO CODE_SIGN_IDENTITY=""
  • Built-binary smoke tests:
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect --help
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect dependencies --help
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect build --help
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect test --help
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect bundle --help
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect implicit-imports --help
    • /private/tmp/tuist-help-dd/Build/Products/Debug/tuist inspect redundant-imports --help
  • git diff --check

The smoke tests confirmed --verbose appears exactly once in each relevant help output.

Comments
T
tuist[bot] Jun 19, 2026

🛠️ Tuist Run Report 🛠️

Tests 🧪
Scheme Status Cache hit rate Tests Skipped Ran Commit
TuistAcceptanceTests 0 % 193 0 193 b998ed54b
TuistUnitTests 0 % 606 39 567 b998ed54b
Failed Tests ❌
Builds 🔨
Scheme Status Duration Commit
TuistAcceptanceTests 4m 42s b998ed54b
TuistUnitTests 4m 28s b998ed54b
TA
tuist-atlas[bot] Jun 20, 2026

The fix to show the verbose flag in inspect help is now available in 4.201.0-canary.18. Update to this version to get it.

TA
tuist-atlas[bot] Jun 21, 2026

The verbose flag is now shown in tuist inspect help output in 4.201.0-canary.19. This makes the --verbose option discoverable when running tuist inspect --help and its subcommands. Update to 4.201.0-canary.19 to get this fix.