SkillHub

obsidian-task

v1.0.1

Manage Obsidian tasks via obsidian-cli. List, toggle, create, and update tasks from the terminal.

Sourced from ClawHub, Authored by Yang Jun

Installation

Please help me install the skill `obsidian-task` from SkillHub official store. npx skills add boyd4y/obsidian-task

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"

```