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"