All commands · intake
pm create
Create a new project management item.
Creates a new planning item with deterministic metadata and history.
Usage
pm create [options] [type-or-title] [title]Arguments
| <type-or-title> | Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`) | optional |
|---|---|---|
| <title> | Item title when the first argument is an item type | optional |
Options
| --title, -t <value> | Item title [required] (or pass title as the first positional argument) | required |
|---|---|---|
| --id <value> | Explicit item id (normalized with the configured id_prefix) | optional |
| --description, -d <value> | Item description (allow empty string) | optional |
| --type <value> | Item type (built-ins plus any configured custom types) | optional |
| --template <value> | Apply named create template defaults before explicit flags | optional |
| --create-mode <value> | Create required-option policy mode: strict|progressive | optional |
| --schedule-preset <value> | Scheduling preset for Reminder|Meeting|Event: lightweight | optional |
| --status, -s <value> | Item status | optional |
| --close-reason <value> | Close reason when creating directly in a terminal status | optional |
| --completed-at <value> | Actual completion time for a terminal imported item | optional |
| --priority, -p <value> | Priority 0..4 | optional |
| --tags <value> | Comma-separated tags | optional |
| --add-tags <value> | Add tags additively on top of --tags (repeatable; CSV accepted) | optional |
| --body, -b <value> | Item markdown body (allow empty string) | optional |
| --deadline <value> | Deadline (ISO/date string or relative +6h/+1d/+2w/+6m) | optional |
| --estimate, --estimated-minutes <value> | Estimated minutes | optional |
| --acceptance-criteria <value> | Acceptance criteria (repeatable; values join with '; '; allow empty string) | optional |
| --definition-of-ready <value> | Definition of ready (allow empty string) | optional |
| --order <value> | Planning order/rank integer | optional |
| --goal <value> | Goal identifier | optional |
| --objective <value> | Objective identifier | optional |
| --value <value> | Business value summary | optional |
| --impact <value> | Business impact summary | optional |
| --outcome <value> | Expected outcome summary | optional |
| --why-now <value> | Why-now rationale | optional |
| --author <value> | Mutation author | optional |
| --message <value> | History message (allow empty string) | optional |
| --assignee <value> | Item assignee | optional |
| --parent <value> | Parent item ID | optional |
| --allow-missing-parent | Allow creating with an unresolved parent reference and emit a validation warning | optional |
| --allow-unresolved-deps | Allow unresolved local dependency targets and emit explicit warning receipts | optional |
| --reviewer <value> | Reviewer | optional |
| --risk <value> | Risk level: low|med|medium|high|critical (med persists as medium) | optional |
| --confidence <value> | Confidence level: 0..100|low|med|medium|high (med persists as medium) | optional |
| --sprint <value> | Sprint identifier | optional |
| --release <value> | Release identifier | optional |
| --blocked-by <value> | Set latest blocked-by item ID or reason; resolved item IDs append a blocked_by dependency edge | optional |
| --blocked-reason <value> | Blocked reason | optional |
| --unblock-note <value> | Unblock rationale note | optional |
| --reporter <value> | Issue reporter | optional |
| --severity <value> | Issue severity: low|med|medium|high|critical (med persists as medium) | optional |
| --environment <value> | Issue environment context | optional |
| --repro-steps <value> | Issue reproduction steps | optional |
| --resolution <value> | Issue resolution summary | optional |
| --expected-result <value> | Issue expected behavior | optional |
| --expected <value> | Short alias for --expected-result | optional |
| --actual-result <value> | Issue observed behavior | optional |
| --actual <value> | Short alias for --actual-result | optional |
| --affected-version <value> | Affected version identifier | optional |
| --fixed-version <value> | Fixed version identifier | optional |
| --component <value> | Issue component ownership | optional |
| --regression [value] | Regression marker; bare flag means true, or pass true|false|1|0 | optional |
| --customer-impact <value> | Customer impact summary | optional |
| --dep <value> | Seed dependency entry (key=value CSV, markdown key:value lines, or - for stdin; repeatable) | optional |
| --type-option <value> | Type option key=value or key=<name>,value=<value> (also accepts key:value and markdown pairs; use - for stdin; repeatable) | optional |
| --field <name=value> | Set a field declared by an active extension registerItemFields registration (repeatable) | optional |
| --unset <field> | Clear scalar metadata field by name (repeatable) | optional |
| --reminder <value> | Seed reminder entry at=<iso|relative>,text=<text> (also accepts markdown pairs and - for stdin; repeatable) | optional |
| --event <value> | Seed event entry start=<iso|relative>,end=<iso|relative>,duration=<relative|30min|PT30M>,title=<text>,all_day=<true|false>,recur_* fields (also accepts markdown pairs and - for stdin; repeatable) | optional |
| --comment <value> | Seed comment entry (text=<value> CSV/markdown pairs or - for stdin; repeatable) | optional |
| --note <value> | Seed note entry (text=<value> CSV/markdown pairs or - for stdin; repeatable) | optional |
| --learning <value> | Seed learning entry (text=<value> CSV/markdown pairs or - for stdin; repeatable) | optional |
| --file <value> | Seed linked file entry (CSV/markdown pairs or - for stdin; repeatable) | optional |
| --test <value> | Seed linked test entry (CSV/markdown pairs or - for stdin; repeatable) | optional |
| --doc <value> | Seed linked doc entry (CSV/markdown pairs or - for stdin; repeatable) | optional |
| --stdin-json | Read a full item JSON document from stdin; explicit flags override document values | optional |
| --body-file <path> | Load body from a file or stdin (-); conflicts with --body | optional |
| --clear-deps | Clear dependency entries | optional |
| --clear-comments | Clear comments | optional |
| --clear-notes | Clear notes | optional |
| --clear-learnings | Clear learnings | optional |
| --clear-files | Clear linked files | optional |
| --clear-tests | Clear linked tests | optional |
| --clear-docs | Clear linked docs | optional |
| --clear-reminders | Clear reminders | optional |
| --clear-events | Clear events | optional |
| --clear-type-options | Clear type options | optional |
| --allow-duplicate | Explicitly create even when strict similarity governance finds likely duplicates | optional |
Examples
pm create --title "Harden lock flow" --description "Improve stale lock handling" --type Task --status open --priority 1 --message "Create lock hardening task" --create-mode progressive