Skip to content

CLI help should show nested command tree #241

@kamilio

Description

@kamilio

Summary

Toolcraft root help currently only lists immediate child groups, for example:

Commands:
slack    Slack messages and channels.
asana    Asana project tasks.
todo     Apple Reminders todos.
calendar Google Calendar events.
approvals Inspect and execute queued approvals.

For CLIs with nested groups, this is not very useful because users cannot see the actual executable commands from root help.

Expected

Root help should show a multi-level command tree, for example:

Commands:
  slack
    fetch_messages   Fetch Slack messages
    list_channels    List Slack channels
  asana
    list_tasks       List tasks
    add_task         Add task
    complete         Complete task
  todo
    add              Add todo
    list             List todos
    lists            List todo lists
  calendar
    events
      list           List calendar events
    meeting
      create         Create meeting
      edit           Edit meeting

Why this matters

Nested MCP proxy groups are a natural way to make command names nicer, but root help only showing top-level group names makes discoverability poor. Users have to repeatedly run subgroup --help commands to find what exists.

Possible behavior

  • Root help displays the full nested tree by default, or
  • Add an option such as runCLI(root, { helpDepth: 2 | "all" }), or
  • Add a global flag like --help-all.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions