Skip to content

Make command discovery and first-use help easier to navigate #159

Closed

Description

@rmcdaniel

The operator's CLI walkthrough found that dw workflow:lst buries the obvious workflow:list correction among alphabetically sorted alternatives. The full command list and workflow:start help also make common first-use actions difficult to find.

Acceptance:

  • Close command matches in the requested namespace come first without changing exact names, aliases or abbreviation dispatch.
  • The default human command list starts with a short working path through profile setup, doctor, start, list, describe and history. The complete reference and machine/raw formats remain available.
  • workflow:start explains a simple invocation before compatibility internals and identifies common versus advanced options.
  • The local default target is explicit in onboarding/help. Existing explicit/profile/environment connection behavior is preserved.
  • --output=json is the recommended form, with --json retained for existing scripts.
  • Focused behavior tests and normal checks pass.

Activity

  1. rmcdaniel commented on Nov 17, 2026

    @rmcdaniel
    MemberAuthor

    Delivered in CLI 2.9.0 (#162). Typo suggestions now rank the requested namespace's nearest command first, and workflow:start --help opens with a quick start and essential options. The released binary passed installed acceptance (see #160).

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

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions