CLI reference
Command overview
All hyper-pm CLI commands at a glance with links to detailed reference.
Every invocation follows:
hyper-pm [global options] <command> [subcommand] [options]Global options must appear before <command>. Details: Global options.
Top-level commands
| Command | Purpose | Details |
|---|---|---|
init | Create/adopt data branch and .hyper-pm/config.json | init & doctor |
doctor | Validate event log replay | init & doctor |
epic | Epics CRUD | Epics & stories |
story | Stories CRUD | Epics & stories |
ticket | Tickets CRUD, work, comment, GitHub import | Tickets |
repo | Read-only helpers on the checked-out repo | repo, sync & audit |
sync | GitHub Issues sync | repo, sync & audit |
audit | Query durable events | repo, sync & audit |
epic subcommands
create · read · update · delete — see Epics & stories.
story subcommands
create · read · update · delete — see Epics & stories.
ticket subcommands
| Subcommand | Summary |
|---|---|
create | New ticket; optional --story, planning fields, --ai-draft |
read | One ticket (--id) or filtered list (omit --id) |
update | Patch fields; branch/label add/remove/clear; --ai-improve |
work | Create/checkout branch, set in_progress, link branch |
comment | Append local comment event |
delete | Soft-delete |
import-github | Import GitHub issues as tickets |
Full flags: Tickets.
repo subcommands
| Subcommand | Summary |
|---|---|
commit-authors | Authors by email (optional login guess) |
suggest-assignee-login | Guess GitHub login from --email |
Help in the terminal
hyper-pm --help
hyper-pm ticket --help
hyper-pm ticket read --help