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.
Summary
Toolcraft root help currently only lists immediate child groups, for example:
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:
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
--helpcommands to find what exists.Possible behavior
runCLI(root, { helpDepth: 2 | "all" }), or--help-all.