Obsidian Tasks Parser

A Rust CLI tool to parse and filter tasks from your Obsidian TaskNotes vault.

Building

cargo build --release

The binary will be at target/release/obsidian-tasks

Usage

# Show all tasks as JSON

obsidian-tasks --path ~/path/to/vault/TaskNotes all

  

# Show today's tasks

obsidian-tasks --path ~/path/to/vault/TaskNotes today

  

# Show overdue tasks

obsidian-tasks --path ~/path/to/vault/TaskNotes overdue

  

# Show pending (not done) tasks

obsidian-tasks --path ~/path/to/vault/TaskNotes pending

  

# Get count of pending tasks (for waybar)

obsidian-tasks --path ~/path/to/vault/TaskNotes count

  

# Get count of today's tasks

obsidian-tasks --path ~/path/to/vault/TaskNotes count --today

  

# Get count of overdue tasks

obsidian-tasks --path ~/path/to/vault/TaskNotes count --overdue

Waybar Integration

Add this to your waybar config:

"custom/tasks": {
"format": " {}",
"exec": "obsidian-tasks --path ~/Obsidian/Vault/TaskNotes count --today",
"interval": 60,
"on-click": "alacritty -e obsidian-tasks --path ~/Obsidian/Vault/TaskNotes today | jq",
"tooltip": true,
"tooltip-format": "Today's tasks"
}

Task Format

This tool expects Obsidian notes with YAML frontmatter like:

---
status: done
priority: medium
dateCreated: 2026-01-30T08:18:47.998-05:00
tags:
- task
projects:
- "[[Fri Jan 30th 2026]]"
due: 2026-01-30
completedDate: 2026-02-01
taskSourceType: taskNotes
---