← Back to issue list

Register the `help` command

View original Github issue

Metadata

Project
craft-cli
Number
#200
Type
issue
State
open
Author
mr-cal
Labels
—
Created
Updated
Closed
—

Current evaluation

The shared CLI handles help implicitly but does not register it, so '<app> help help' reports that help is missing. The maintainer-authored request remains open and reproducible.

Suggested action: keep open

Reason: The maintainer-authored report provides an exact reproducer and clear desired behavior. In craft_cli/dispatcher.py, help is special-cased before dispatch but absent from self.commands, so _get_requested_help raises the reported error; the current code and history show no resolving change.

Evaluated by: mr-cal-bot

Impact: 30 Quick Win: 18 Complexity: 32 Confidence: 96 Actionability: 86

Issue body

### What needs to get done Register help as a command so it can provide help text for itself. ### Why it needs to get done Consider the following user experience. Rockcraft suggests using the `help` command: ``` > rockcraft help Usage: rockcraft [help] <command> ... For more information about a command, run 'rockcraft help <command>'. ``` However, `help` does not have any help itself: ``` > rockcraft help help Usage: rockcraft [options] command [args]... Try 'rockcraft -h' for help. Error: command 'help' not found to provide help for ``` Snapcraft is an interesting example because it has a help command registered in snapcraft_legacy. Source: [LP#2043012](https://bugs.launchpad.net/snapcraft/+bug/2043012) from @brlin-tw

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 30
Quick Win: 18
Complexity: 32
Confidence: 96
Actionability: 86
keep open The shared CLI handles help implicitly but does not register it, so '<app> help help' reports that help is missing. The maintainer-authored request remains open and reproducible.
qwen/qwen3.6-35b-a3b
Impact: 35
Quick Win: 24
Complexity: 15
Confidence: 70
Actionability: 80
needs triage Register a help command so 'rockcraft help help' works. Open 1047 days with no labels, comments, or maintainer response.
qwen/qwen3.8-27b
Impact: 25
Quick Win: 18
Staleness: 75
Complexity: 30
Confidence: 70
Support Request: 10
needs triage Feature request to register 'help' as a first-class command in craft-cli so 'craft help help' works instead of erroring with 'command help not found'. No labels, no comments, no activity since creation ~2.8 years ago; still unimplemented in current code.
qwen/qwen3.6-35b-a3b
Staleness: 95
Complexity: 20
Confidence: 85
Support Request: 10
needs triage Feature request to register the `help` command for self-documentation. Issue is 986 days old, no maintainer response, no labels, and lacks active discussion or triage.
qwen3.6-35b-a3b-mtp-q6
Staleness: 95
Complexity: 10
Confidence: 70
Support Request: 5
needs triage Missing help command registration causes rockcraft help help to fail. Open for 2.5 years with no maintainer response or labels.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.