Tasktrove
by @willwebberley
Manage todos via Tasktrove API. Use for listing, creating, completing, or updating tasks. Triggers on task/todo requests like "what's on my todo list", "add a task", "mark X done", "what's due today".
clawhub install tasktroveπ About This Skill
name: tasktrove description: Manage todos via Tasktrove API. Use for listing, creating, completing, or updating tasks. Triggers on task/todo requests like "what's on my todo list", "add a task", "mark X done", "what's due today".
Tasktrove Todo Management
Manage tasks via a self-hosted Tasktrove instance. (GitHub)
Configuration
Set the following environment variable:
export TASKTROVE_HOST="http://your-server:3333"
Optionally, if your instance requires authentication:
export TASKTROVE_TOKEN="your-api-token"
Quick Reference
Using the CLI script
# List today's tasks
python3 scripts/tasks.py list --todayList overdue tasks
python3 scripts/tasks.py list --overdueList this week's tasks
python3 scripts/tasks.py list --weekAdd a task
python3 scripts/tasks.py add "Task title" --due 2026-02-10 --priority 2Complete a task (use ID prefix from list output)
python3 scripts/tasks.py complete abc123Search tasks
python3 scripts/tasks.py search "keyword"
Direct API calls
#### List Tasks
curl -s "$TASKTROVE_HOST/api/v1/tasks"
#### Create Task
# Note: API requires all fields including id, completed, labels, etc.
curl -X POST "$TASKTROVE_HOST/api/v1/tasks" \
-H "Content-Type: application/json" \
-d '{
"id": "",
"title": "Task title",
"priority": 4,
"dueDate": "2026-02-06",
"completed": false,
"labels": [],
"subtasks": [],
"comments": [],
"createdAt": "2026-02-06T12:00:00.000Z",
"recurringMode": "dueDate"
}'
#### Complete/Update Task
# Note: PATCH goes to collection endpoint with ID in body (not /tasks/{id})
curl -X PATCH "$TASKTROVE_HOST/api/v1/tasks" \
-H "Content-Type: application/json" \
-d '{"id": "", "completed": true}'
#### Delete Task
curl -X DELETE "$TASKTROVE_HOST/api/v1/tasks/"
Task Schema
| Field | Type | Notes | |-------|------|-------| | id | string | UUID (required on create) | | title | string | Required | | description | string | Optional | | completed | boolean | Default false | | priority | number | 1 (highest) to 4 (lowest) | | dueDate | string | YYYY-MM-DD format | | projectId | string | UUID of project | | labels | string[] | Array of label UUIDs | | subtasks | object[] | Nested subtasks | | recurring | string | RRULE format |
Priority Levels
Notes
βοΈ Configuration
Set the following environment variable:
export TASKTROVE_HOST="http://your-server:3333"
Optionally, if your instance requires authentication:
export TASKTROVE_TOKEN="your-api-token"