Skip to content

[Feature]: Show argument hints when no more subcommands available #127

Open

Description

@ludvignaslund

Is your feature request related to a problem?

When pressing tab on a leaf command, nothing is suggested if the user hasn't typed a flag prefix. There is no indication of what argument is expected next.

Describe the solution you'd like

When tab-completing a command that has no subcommands (a leaf command), and the user hasn't started typing a flag (-), the completion should display the next expected positional argument as a hint (e.g. ).

If the command has registered arguments and the user is at the position of the next argument, the completion should display the argument placeholder as a hint e.g.:
command subcommand <TAB>
<argument> -- Description of the argument

Describe alternatives you've considered

No response

Additional context

No response

AI assistance disclosure

  • This feature request was drafted with the assistance of an AI tool.

Activity

  1. AmirSa12 commented on Jun 9, 2026

    @AmirSa12
    Member

    Hi @ludvignaslund !
    Thanks for opening this issue. seems like a good feature. will def look into it.

  2. ludvignaslund commented on Jun 22, 2026

    @ludvignaslund
    Author

    Hi! I noticed that you made an update regarding positional arguments in the latest version (0.0.17). Was that related to this issue or was it something else? I cannot seem to get it to work with argument suggestions in this version using the same setup (const completion = tab(program).

    Best, Ludvig.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions