Menu
Create a new task in the pool via CLI. Use when the user wants to add a task, create a subtask, or populate the task pool.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Edit, update, complete, or cancel tasks in the pool. Use when the user wants to modify task fields, mark tasks done, or manage task lifecycle.
Reference for subcontext pool and task data model. Use when you need to understand how pools, tasks, TASK.md frontmatter, and index.db work.
| name | add-task |
| description | Create a new task in the pool via CLI. Use when the user wants to add a task, create a subtask, or populate the task pool. |
subcontext task add "Title" [options]
| Flag | Description |
|---|---|
--list X | Grouping label (e.g. work, personal) |
--topic Y | Topic tag |
--type Z | Task type: todo (default), goal, task, tick |
--status S | Initial status: active (default) |
--important | Mark as important |
--deadline D | Deadline (ISO 8601 timestamp) |
--parents 1,2 | Parent task IDs (comma-separated) |
--uuid U | Explicit UUID for cross-context references |
# Simple task
subcontext task add "Write documentation"
# Task with metadata
subcontext task add "Deploy v2" --list work --topic infra --deadline 2026-06-01T00:00:00Z
# Important subtask
subcontext task add "Fix auth bug" --important --parents 3
# Task with explicit type
subcontext task add "Weekly review" --type tick
The command prints the assigned task ID to stdout.
Tasks are stored in the pool at .git/.subcontext/pool/tasks/{id}/TASK.md.
subcontext task done <id> # mark as done
subcontext task fail <id> # mark as cancelled
subcontext task done <id> --time T # with explicit timestamp
--global -- operate on the system-level subcontext--user -- operate on the user subcontext--local -- only act on the local (per-repo) subcontext