Use the CLI
Read CLI output and identifiers
Choose Markdown or JSON output and keep project, task, work-run, session, and draft identifiers distinct.
Default output is Markdown or concise status text for direct reading. Commands that support --json return structured output for reliable parsing. A nonzero exit means the operation did not succeed.
| Identifier | Used for | Do not substitute |
|---|---|---|
projectId | Project-scoped commands and optional --project | A task number or session number |
taskNumber | task get, task update, task delete, and task comment | A task ID or work-run ID |
taskWorkRunId | work-run get and work-run complete | A task number |
sessionNumber | Task Builder sessions and --session | A Plan or draft position |
draftPlanId | Proposed Plan mutations and task membership | A mutable Plan position |
draftId | Draft-task mutations | A mutable draft position |
| Plan position | Proposed Plan display context | A stable proposed Plan ID |
| Draft position | Display and ordering context | A stable draft ID |
Task comments, work-run summaries and hand-offs, proposed Plan content, and draft-task content accept inline Markdown or a file, but not both forms for the same value. Plan Markdown is optional; task Markdown is required. Use a file for multiline or shell-sensitive content. The CLI command reference explains the exact resolution rules.