#208 cli: --help should be terse and complete; subcommands should support --help for verbose detail

[Anonymous]

Originally created by: kumaakh

Problem

The CLI help is neither complete nor explorable:

• apra-fleet --help lists some install variants but omits --llm and --force entirely
• apra-fleet install --help exists but is undiscoverable — nothing points to it
• A user reading apra-fleet --help gets an incomplete picture and no signal that more detail is available

Proposed design

Top-level apra-fleet --help — terse, one line per option, covers everything:

Usage:
  apra-fleet                           Start MCP server (stdio)
  apra-fleet install                   Install binary, hooks, MCP server, and skills
    --llm <provider>                   Target LLM provider: claude (default), gemini, codex, copilot
    --skill all|fleet|pm|none          Which skills to install (default: all)
    --no-skill                         Skip skill installation
    --force                            Stop running server before installing
  apra-fleet auth <name>               Provide password for pending member registration
  apra-fleet --version                 Print version
  apra-fleet --help                    Show this help

Run 'apra-fleet <subcommand> --help' for detailed usage.

apra-fleet install --help — verbose, with descriptions, examples, and notes (current content is a good base, keep and expand it).

Why

Every option is visible in one place. Users don't need to know that subcommands have their own --help to discover flags like --llm. The closing line teaches the pattern for future subcommands.

[Anonymous]

Ticket changed by: kumaakh

• status: open --> closed