Skip to content

feat: Improve CLI help and status display for token awareness#338

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

feat: Improve CLI help and status display for token awareness#338
aronchick wants to merge 1 commit intodlorenc:mainfrom
aronchick:work/cool-otter

Conversation

@aronchick
Copy link
Copy Markdown
Contributor

Summary

  • Add LongDescription field to Command struct for detailed help text
  • Add comprehensive help for repo hibernate explaining it stops ALL token consumption
  • Show specific active agents in multiclaude status (supervisor, merge-queue, workspace) instead of just "X core, Y workers"
  • Add token consumption warning (⚠) when agents are active, pointing users to hibernate --all

Changes

internal/cli/cli.go:

  • Added LongDescription field to Command struct
  • Updated showCommandHelp() to display LongDescription when present
  • Added detailed help text for repo hibernate command
  • Updated systemStatus() to show individual agent names and types
  • Added token consumption warning with hibernate hint

internal/daemon/daemon.go:

  • Updated handleListRepos() to return core_agents (name + type) and worker_names arrays instead of just counts

Test plan

  • go build ./cmd/multiclaude - builds successfully
  • go test ./... - all tests pass
  • Manual: multiclaude repo hibernate --help shows detailed help about token consumption
  • Manual: multiclaude status shows specific agents (e.g., "supervisor (supervisor), merge-queue (merge-queue)")
  • Manual: Status shows warning "⚠ N active agent(s) consuming API tokens"

🤖 Generated with Claude Code

- Add LongDescription field to Command struct for detailed help text
- Add comprehensive help for 'repo hibernate' explaining token consumption
- Show specific active agents in 'multiclaude status' (supervisor, merge-queue, etc.)
  instead of just 'X core, Y workers'
- Add token consumption warning when agents are active
- Point users to 'hibernate --all' to stop token usage

This makes hibernate more discoverable and helps users understand that
running agents continuously consume API tokens.

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
…(context-aware refresh)

13 new tests covering token-aware status display, LongDescription help,
handleListRepos enriched response, context-aware refresh path detection,
--all flag parsing, and worktree path edge cases.

Findings documented at /tmp/swarm-tests-338-339.md including:
- PR dlorenc#338 depends on unmerged ForkConfig PR
- PR dlorenc#339 symlink handling is correct
- Both PRs are independent with no conflicts

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>
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