Skip to content

feat(cli): improve help output with categorized commands#337

Open
aronchick wants to merge 1 commit intodlorenc:mainfrom
aronchick:work/cool-wolf
Open

feat(cli): improve help output with categorized commands#337
aronchick wants to merge 1 commit intodlorenc:mainfrom
aronchick:work/cool-wolf

Conversation

@aronchick
Copy link
Copy Markdown
Contributor

Summary

  • Restructures CLI help output from flat alphabetical list to 6 logical categories
  • Adds QUICK START section showing the 4 most common commands
  • Hides 7 redundant aliases from help (still functional, just not displayed)
  • Reduces cognitive load: 21 focused commands vs 28 scattered entries

Changes

Before:

Subcommands:
  repair, refresh, config, version, claude, docs, review, agents, start,
  list, worker, agent, message, logs, bug, diagnostics, status, daemon,
  stop-all, repo, init, work, workspace, cleanup, history, attach

After:

QUICK START:
  repo init <url>     Track a GitHub repository
  start               Start the daemon
  worker "task"       Create a worker for a task
  status              See what's running

DAEMON:
  daemon, stop-all

REPOSITORIES:
  config, repo

AGENTS:
  agent, agents, claude, review, worker, workspace

COMMUNICATION:
  message

MAINTENANCE:
  cleanup, logs, refresh, repair, status

META:
  bug, diagnostics, docs, version

Implementation

  • Added Hidden and Category fields to Command struct
  • Hidden aliases still work but don't clutter help output
  • Created docs/CLI_RESTRUCTURE_PROPOSAL.md with analysis and v2.0 roadmap

Test plan

  • go test ./... - all tests pass
  • ./multiclaude --help shows categorized output
  • ./multiclaude (no args) shows same categorized output
  • Hidden aliases (init, list, work, etc.) still function correctly

Aligns with ROADMAP P2 "Better onboarding".

🤖 Generated with Claude Code

Restructures the CLI help output to be more user-friendly:

- Add QUICK START section showing the 4 most common commands
- Group commands into 6 categories: DAEMON, REPOSITORIES, AGENTS,
  COMMUNICATION, MAINTENANCE, META
- Hide 7 redundant aliases from help (still functional, just not displayed)
- Add Hidden and Category fields to Command struct for flexibility

The help output now shows 21 focused commands instead of 28 scattered
entries, making it much easier for new users to understand what to do.

Also adds CLI_RESTRUCTURE_PROPOSAL.md documenting the analysis and
future restructuring options for v2.0.

Aligns with ROADMAP P2 "Better onboarding".

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@aronchick
Copy link
Copy Markdown
Contributor Author

Merge Queue: READY TO MERGE

  • CI: All 6 checks passing
  • Merge status: MERGEABLE/CLEAN
  • Reviews: None blocking

This PR is ready for maintainer merge.

@aronchick aronchick marked this pull request as ready for review January 31, 2026 21:27
whitmo added a commit to whitmo/multiclaude that referenced this pull request Mar 1, 2026
whitmo added a commit to whitmo/multiclaude that referenced this pull request Mar 1, 2026
whitmo added a commit to whitmo/multiclaude that referenced this pull request Mar 1, 2026
…#337)

14 tests covering: category assignment for all commands, hidden command
exclusion from help, categorized output format with sorted sections,
QUICK START section, LongDescription display, and subcommand help.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
whitmo added a commit to whitmo/multiclaude that referenced this pull request Mar 1, 2026
…c#333 on pr-triage-b2

Tests from multiclaude workers (silly-otter, lively-otter, clever-bear):
- PR dlorenc#338: Token-aware status display, hibernate help, rich list_repos response
- PR dlorenc#339: Context-aware refresh, worktree path detection, --all flag parsing
- PR dlorenc#337: Categorized help (worker report captured, tests via CLI assertions)
- PR dlorenc#333: Enhanced repair (worker report captured, daemon handler tests)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
whitmo added a commit to whitmo/multiclaude that referenced this pull request Mar 1, 2026
This draft proposal is obsolete — key recommendations have already
been implemented:
- Categorized help output (PR dlorenc#337)
- Hidden command field concept in Command struct
- agents command restructuring

The remaining suggestions (deprecation warnings, guide command,
templates rename) can be revisited as standalone issues if needed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
whitmo added a commit to whitmo/multiclaude that referenced this pull request Mar 1, 2026
Resolved conflicts with dlorenc#337 categorized help: kept categorized output
and added JSON hint line. showCommandHelp now supports both outputJSON
parameter and root command redirect to categorized help.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant