Tasktrove Todo Management
Manage tasks via a self-hosted Tasktrove instance. (GitHub)
Configuration
Set the following environment variable:
CODEBLOCK0
Optionally, if your instance requires authentication:
CODEBLOCK1
Quick Reference
Using the CLI script
CODEBLOCK2
Direct API calls
List Tasks
CODEBLOCK3
Create Task
CODEBLOCK4
Complete/Update Task
CODEBLOCK5
Delete Task
CODEBLOCK6
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
- - P1: Urgent/critical
- P2: High priority
- P3: Medium priority
- P4: Low priority (default)
Notes
- - The Tasktrove UI supports natural language input, but the API expects structured JSON
- PATCH operations use the collection endpoint with ID in the request body
- POST requires all schema fields to be present
Tasktrove 任务管理
通过自托管的 Tasktrove 实例管理任务。(GitHub)
配置
设置以下环境变量：
bash
export TASKTROVE_HOST=http://your-server:3333
如果您的实例需要身份验证，可选择性设置：
bash
export TASKTROVE_TOKEN=your-api-token
快速参考
使用 CLI 脚本
bash
列出今日任务
python3 scripts/tasks.py list --today
列出逾期任务
python3 scripts/tasks.py list --overdue
列出本周任务
python3 scripts/tasks.py list --week
添加任务
python3 scripts/tasks.py add 任务标题 --due 2026-02-10 --priority 2
完成任务（使用列表输出中的 ID 前缀）
python3 scripts/tasks.py complete abc123
搜索任务
python3 scripts/tasks.py search 关键词
直接 API 调用
列出任务
bash
curl -s $TASKTROVE_HOST/api/v1/tasks
创建任务
bash
注意：API 需要所有字段，包括 id、completed、labels 等
curl -X POST $TASKTROVE_HOST/api/v1/tasks \
-H Content-Type: application/json \
-d {
id:
,
title: 任务标题,
priority: 4,
dueDate: 2026-02-06,
completed: false,
labels: [],
subtasks: [],
comments: [],
createdAt: 2026-02-06T12:00:00.000Z,
recurringMode: dueDate
}
完成/更新任务
bash
注意：PATCH 请求发送到集合端点，ID 在请求体中（而非 /tasks/{id}）
curl -X PATCH $TASKTROVE_HOST/api/v1/tasks \
-H Content-Type: application/json \
-d {id: , completed: true}
删除任务
bash
curl -X DELETE $TASKTROVE_HOST/api/v1/tasks/
任务模式
| 字段 | 类型 | 说明 |
|---|
| id | 字符串 | UUID（创建时必填） |
| title |
字符串 | 必填 |
| description | 字符串 | 可选 |
| completed | 布尔值 | 默认为 false |
| priority | 数字 | 1（最高）到 4（最低） |
| dueDate | 字符串 | YYYY-MM-DD 格式 |
| projectId | 字符串 | 项目的 UUID |
| labels | 字符串数组 | 标签 UUID 数组 |
| subtasks | 对象数组 | 嵌套子任务 |
| recurring | 字符串 | RRULE 格式 |
优先级级别
- - P1：紧急/关键
- P2：高优先级
- P3：中优先级
- P4：低优先级（默认）
说明
- - Tasktrove 用户界面支持自然语言输入，但 API 期望结构化 JSON
- PATCH 操作使用集合端点，ID 在请求体中
- POST 请求需要包含所有模式字段
