[BUG][v0.0.7] `--add-dir`: usage shows `<DIR>` (singular) while help says "Additional directories" (plural) — confusing vs repeatable flag

[andrirevo]

Project

cortex

Description

Global cortex --help shows --add-dir <DIR> with a singular placeholder while the help sentence refers to “directories” in plural. Clap’s behavior is to allow repeating the flag, but the global help does not explain repetition explicitly, unlike some subcommands’ help text which adds a clarifying second line. Users may think a single flag can accept multiple paths, or conversely think multiple directories cannot be expressed.

Error Message

Debug Logs

System Information

OS: Windows 11

Screenshots

https://github.com/springoliver/bounty_challenge_report_image/blob/main/49112.png

Steps to Reproduce

1. Open a terminal in a repo where cortex is configured.
2. Run cortex --help.
3. Compare output/behavior with the issue narrative for this ID.

Expected Behavior

The reporter expects cortex to match documented CLI/TUI contracts for this flow—correct output, honest flags/help, and no silent contradictions—consistent with the problem statement at the top of this rewrite.

Actual Behavior

Global cortex --help shows --add-dir <DIR> with a singular placeholder while the help sentence refers to “directories” in plural. Clap’s behavior is to allow repeating the flag, but the global help does not explain repetition explicitly, unlike some subcommands’ help text which adds a clarifying second line. Users may think a single flag can accept multiple paths, or conversely think multiple directories cannot be expressed.

Additional Context

No response

[watcharaponthod-code]

I have submitted a fix for this issue here: CortexLM/cortex-code#232

Changes

• Updated the value_name of the --add-dir argument from DIR to DIRS in src/cortex-cli/src/cli/args.rs to match the plural context of the help description.