Obsidian Task
Manage tasks in your Obsidian vault using the official Obsidian CLI.
Dependencies
| Dependency | Required | Description |
|---|
obsidian | Yes | Obsidian CLI (registered via Obsidian settings) |
Obsidian 1.12+ | Yes | Catalyst license required for CLI access |
Check Dependencies
# Check obsidian CLI availability
obsidian version
Prerequisites
- Obsidian 1.12+ and Catalyst license required
- Settings → General → Command line interface → Enable
- Follow prompt to register the
obsidian command
- Restart terminal or
source ~/.zprofile (macOS)
- Note: Obsidian must be running for CLI to work
Test setup: obsidian version
Usage
/obsidian-task [command] [options]
Commands
| Command | Description |
|---|
| (none) | Show help and available commands |
Options
| Option | Description |
|---|
--help | Show help message |
Examples
# List tasks
/obsidian-task tasks file=projects/myproject/todo verbose
# Toggle task on line 2
/obsidian-task task file=projects/myproject/todo line=2 toggle
# Mark task as done
/obsidian-task task file=projects/myproject/todo line=2 done
# Mark task as todo (undo completion)
/obsidian-task task file=projects/myproject/todo line=2 todo
# Create new task
/obsidian-task append file=projects/myproject/todo content="- [ ] task name"
Raw CLI Commands
# List tasks (shows line numbers and status)
obsidian tasks file=<project_slug>/todo verbose
# Sample output:
# projects/<project_slug>/TODO.md
# 2 - [ ] 未完成的任务
# 3 - [x] 已完成的任务
# Update tasks
obsidian task file=<project_slug>/todo line=2 toggle
obsidian task file=<project_slug>/todo line=2 done
obsidian task file=<project_slug>/todo line=2 todo
# Create new task (via append)
obsidian append file=<project_slug>/todo content="- [ ] task name"