Task Management

Tasks are first-class entities and support status-based flow without separate systems.

What this page covers

How to create, list, and complete tasks through CLI and API.

Core workflow

1. Create a task:

pgm task add "write API docs" --context @focus --status next

2. List by status/context:

pgm task list --status next --context @focus

3. Update task fields:

pgm task update <id> --status waiting --version 1

4. Mark done:

pgm task complete <id> --version 2

5. REST flow:

• POST /api/tasks
• GET /api/tasks
• PATCH /api/tasks/:id
• POST /api/tasks/:id/complete

Notes

• type is set to task on creation.
• Completion writes a completion timestamp into metadata.
• Keep context labels and due dates consistent if you are integrating with schedulers or automation.