Obsidian Tasknotes

TaskNotes 技能

Manage Obsidian tasks via the TaskNotes 插件 HTTP API.

Requirements TaskNotes 插件 安装ed in Obsidian Enable HTTP API in TaskNotes 设置tings: Open Obsidian 设置tings → TaskNotes Enable "HTTP API" toggle 设置 API port (default: 8080) API 令牌: leave empty for no auth, or 设置 a 令牌 for security 环境 variables in .env file at vault root (if using auth): TASKNOTES_API_PORT=8080 TASKNOTES_API_KEY=your_令牌_here

If TaskNotes has no auth 令牌 设置, you don't need a .env file. 命令行工具 Commands # 列出 all tasks uv 运行 scripts/tasks.py 列出

# 列出 by 状态 (use your 配置d 状态 values) uv 运行 scripts/tasks.py 列出 --状态 "in-进度"

# 列出 by project uv 运行 scripts/tasks.py 列出 --project "My Project"

# 创建 task uv 运行 scripts/tasks.py 创建 "Task title" --project "My Project" --priority high

# 创建 task with scheduled time uv 运行 scripts/tasks.py 创建 "Meeting prep" --scheduled "2025-01-15T14:00:00"

# 更新 task 状态 uv 运行 scripts/tasks.py 更新 "Tasks/task-file.md" --状态 done

# 添加/更新 task description uv 运行 scripts/tasks.py 更新 "Tasks/task-file.md" --detAIls "添加itional 上下文 here."

# 删除 task uv 运行 scripts/tasks.py 删除 "Tasks/task-file.md"

# 获取 avAIlable options (状态es, priorities, projects) uv 运行 scripts/tasks.py options --table

# Human-readable 输出 (添加 --table) uv 运行 scripts/tasks.py 列出 --table

Task Properties

状态 and Priority values: 配置d in your TaskNotes 插件 设置tings. 运行 options command to see avAIlable values:

uv 运行 scripts/tasks.py options --table

Other fields:

projects - Array of project links, e.g. ["[[Project Name]]"] 上下文s - Array like ["office", "energy-high"] due - Due date (YYYY-MM-DD) scheduled - Scheduled date/time (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS) timeEstimate - Minutes (number) tags - Array of tags detAIls - Task description (writes to markdown body, not frontmatter) API Reference

Base URL: http://localhost:8080/API

Method 端点 Description 获取 /tasks 列出 tasks (supports 过滤器s) POST /tasks 创建 task 获取 /tasks/{id} 获取 single task PUT /tasks/{id} 更新 task 删除 /tasks/{id} 删除 task 获取 /过滤器-options AvAIlable 状态es, priorities, projects 查询 Parameters for 获取 /tasks 状态 - 过滤器 by 状态 project - 过滤器 by project name priority - 过滤器 by priority tag - 过滤器 by tag overdue - true/false 排序 - 排序 field limit - Max 结果s off设置 - Pagination off设置 When to Use "创建 a task for X" → 创建 task "show my tasks" → 列出 all tasks "show in-进度 tasks" → 列出 --状态 in-进度 "mark X as done" → 更新 task 状态 to done "what should I work on" → 列出 tasks by 状态 Example 工作流 # Morning: 检查 what to work on uv 运行 scripts/tasks.py 列出 --状态 in-进度 --table uv 运行 scripts/tasks.py 列出 --limit 5 --table

# 创建 task linked to project uv 运行 scripts/tasks.py 创建 "Finish landing page" \ --project "网页site Rede签名" \ --priority high

# Complete a task uv 运行 scripts/tasks.py 更新 "Tasks/finish-landing-page.md" --状态 done