CLI Commands
The Pensum CLI reads your vault directly. No running plugin required.
Global options
Section titled “Global options”| Option | Description |
|---|---|
--vault, -v <path> | Vault root. Default: current directory. |
--format json|text | Output format. Default: auto-detect. |
Exit codes
Section titled “Exit codes”| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | User error |
| 2 | System error |
task list
Section titled “task list”pensum task list # all open taskspensum task list --filter today # due today + overduepensum task list --filter inbox # inbox taskspensum task list --filter overdue # past-duepensum task list --filter week # next 7 daystask show
Section titled “task show”pensum task show <ulid>task add
Section titled “task add”pensum task add "Fix Caddy config" --due 2026-05-20 --priority high --tags homelabtask complete
Section titled “task complete”pensum task complete <ulid>project list
Section titled “project list”pensum project listproject dashboard
Section titled “project dashboard”pensum project dashboard <name>wiki list
Section titled “wiki list”pensum wiki listschema
Section titled “schema”pensum schema # JSON command catalogdoctor
Section titled “doctor”pensum doctor # vault health check