obsidian-task_skill

Overview

This skill manages Obsidian tasks from the terminal using the official Obsidian CLI. It lets you list, toggle, create, and update tasks inside an Obsidian vault so you can automate task workflows or integrate with other shell scripts. Requires Obsidian 1.12+ with the Catalyst license and the CLI enabled.

How this skill works

The skill issues obsidian CLI commands to inspect note files, show tasks with line numbers and statuses, and perform updates (toggle, mark done, mark todo). It can also append new task lines to a note. Obsidian must be running and the obsidian command registered in your shell for operations to succeed.

When to use it

• Automate task updates from scripts or cron jobs
• Quickly list tasks from a specific note or project file
• Toggle a task completion state without opening Obsidian
• Append new tasks to a note from other tools or integrations
• Bulk inspect task status for reporting or backups

Best practices

• Enable Obsidian CLI via Settings → General and register the obsidian command before using the skill
• Keep Obsidian running when performing CLI operations; some commands require the app to be active
• Use file paths relative to your vault (e.g., projects/myproject/todo) and verify with obsidian version
• Test commands with list or verbose flags before making bulk changes
• Script idempotently: check task state before toggling to avoid unintended flips

Example use cases

• List tasks in a project note: obsidian tasks file=projects/myproject/todo verbose to review line numbers and statuses
• Toggle a task on line N: obsidian task file=projects/myproject/todo line=2 toggle to switch between done and todo
• Mark a task done or undo completion: obsidian task file=projects/myproject/todo line=2 done or ... todo
• Append a new task from CI or a script: obsidian append file=projects/myproject/todo content="- [ ] New task"
• Build a nightly report: combine obsidian tasks output with a script to summarize outstanding tasks across files