Verk Task Management
You can manage tasks, projects, and automation flows in Verk using the verk-cli.mjs CLI tool.
Available Commands
Tasks
- List tasks:
node scripts/verk-cli.mjs tasks list [--status STATUS] [--priority PRIORITY] [--search QUERY]
- Get task:
node scripts/verk-cli.mjs tasks get <taskId>
- Create task:
node scripts/verk-cli.mjs tasks create --title "Title" [--description "Desc"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]
- Update task:
node scripts/verk-cli.mjs tasks update <taskId> [--title "New Title"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]
- Delete task:
node scripts/verk-cli.mjs tasks delete <taskId>
- Comment on task:
node scripts/verk-cli.mjs tasks comment <taskId> --text "Comment text"
Projects
- List projects:
node scripts/verk-cli.mjs projects list
Flows (Automation Workflows)
- List flows:
node scripts/verk-cli.mjs flows list
Valid Values
- Status:
Backlog, Todo, In-Progress, Review, Done
- Priority:
Urgent, High, Medium, Low, None
When to Use Each Command
- When asked to see what tasks exist, use
tasks list. Add --status or --priority to filter, or --search to find specific tasks.
- When asked about a specific task, use
tasks get <taskId>.
- When asked to create a task, use
tasks create with at least a --title.
- When asked to update, change, or modify a task, use
tasks update <taskId> with the fields to change.
- When asked to mark a task as done/complete, use
tasks update <taskId> --status Done.
- When asked to assign a task, use
tasks update <taskId> --assigned userId.
- When asked to delete or remove a task, use
tasks delete <taskId>.
- When asked to comment on or add a note to a task, use
tasks comment <taskId> --text "...".
- When asked about projects, use
projects list.
- When asked about automation workflows, use
flows list.
- To see comments on a task, use
tasks get <taskId> — comments are included in the task response.
Output Format
All commands return JSON. Parse the output to extract relevant information for the user. When listing tasks, summarize key fields (title, status, priority, assignee) rather than dumping raw JSON.
Examples
# List all high-priority tasks
node scripts/verk-cli.mjs tasks list --priority High
# Create a task and assign it
node scripts/verk-cli.mjs tasks create --title "Review Q2 roadmap" --priority High --status Todo
# Mark a task as done
node scripts/verk-cli.mjs tasks update task-abc123 --status Done
# Add a comment
node scripts/verk-cli.mjs tasks comment task-abc123 --text "Completed the review, looks good"
1---2name: verk3description: Manage tasks, projects, and workflows in Verk — AI-powered task management. Create, update, assign, and track tasks. Add comments, change status, list automation flows.4---5
6# Verk Task Management
7
8You can manage tasks, projects, and automation flows in Verk using the `verk-cli.mjs` CLI tool.
9
10## Available Commands
11
12### Tasks
13
14- **List tasks**: `node scripts/verk-cli.mjs tasks list [--status STATUS] [--priority PRIORITY] [--search QUERY]`
15- **Get task**: `node scripts/verk-cli.mjs tasks get <taskId>`
16- **Create task**: `node scripts/verk-cli.mjs tasks create --title "Title" [--description "Desc"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]`
17- **Update task**: `node scripts/verk-cli.mjs tasks update <taskId> [--title "New Title"] [--status STATUS] [--priority PRIORITY] [--assigned userId1,userId2]`
18- **Delete task**: `node scripts/verk-cli.mjs tasks delete <taskId>`
19- **Comment on task**: `node scripts/verk-cli.mjs tasks comment <taskId> --text "Comment text"`
20
21### Projects
22
23- **List projects**: `node scripts/verk-cli.mjs projects list`
24
25### Flows (Automation Workflows)
26
27- **List flows**: `node scripts/verk-cli.mjs flows list`
28
29## Valid Values
30
31- **Status**: `Backlog`, `Todo`, `In-Progress`, `Review`, `Done`
32- **Priority**: `Urgent`, `High`, `Medium`, `Low`, `None`
33
34## When to Use Each Command
35
36- When asked to see what tasks exist, use `tasks list`. Add `--status` or `--priority` to filter, or `--search` to find specific tasks.
37- When asked about a specific task, use `tasks get <taskId>`.
38- When asked to create a task, use `tasks create` with at least a `--title`.
39- When asked to update, change, or modify a task, use `tasks update <taskId>` with the fields to change.
40- When asked to mark a task as done/complete, use `tasks update <taskId> --status Done`.
41- When asked to assign a task, use `tasks update <taskId> --assigned userId`.
42- When asked to delete or remove a task, use `tasks delete <taskId>`.
43- When asked to comment on or add a note to a task, use `tasks comment <taskId> --text "..."`.
44- When asked about projects, use `projects list`.
45- When asked about automation workflows, use `flows list`.
46- To see comments on a task, use `tasks get <taskId>` — comments are included in the task response.
47
48## Output Format
49
50All commands return JSON. Parse the output to extract relevant information for the user. When listing tasks, summarize key fields (title, status, priority, assignee) rather than dumping raw JSON.
51
52## Examples
53
54```bash
55# List all high-priority tasks
56node scripts/verk-cli.mjs tasks list --priority High
57
58# Create a task and assign it
59node scripts/verk-cli.mjs tasks create --title "Review Q2 roadmap" --priority High --status Todo
60
61# Mark a task as done
62node scripts/verk-cli.mjs tasks update task-abc123 --status Done
63
64# Add a comment
65node scripts/verk-cli.mjs tasks comment task-abc123 --text "Completed the review, looks good"
66```