CLI reference
Epics & stories
Create, read, update, and soft-delete epics and stories.
Status values
For --status on create/update, allowed values are:
backlog · todo · in_progress · done · cancelled
Epics default to backlog on create when omitted; stories default to backlog; tickets default to todo (see Tickets).
How these entities relate and how deletes work is described under Data model.
epic
| Subcommand | Purpose | Notable flags |
|---|---|---|
create | Create an epic | --title (required); --body, --id, --status |
read | One epic or list | --id omit for all |
update | Patch fields | --id (required); --title, --body, --status |
delete | Soft-delete | --id (required) |
story
| Subcommand | Purpose | Notable flags |
|---|---|---|
create | Create under an epic | --title, --epic (required); --body, --id, --status |
read | One or list | --id; when listing, optional --epic filter |
update | Patch | --id; --title, --body, --status |
delete | Soft-delete | --id |
Status values align with the data model page.