Skip to content

Obsidian Todo Reschedule as a Claude Code Skill

  • Date: 2026-03-16
  • Status: Accepted
  • Tags: tooling workflow lifeos

Context

Incomplete tasks in the LifeOS Obsidian vault accumulate across daily notes and project files with past 📅 YYYY-MM-DD scheduled dates. Without intervention, these pile up across weeks and months of notes, cluttering the calendar view in Obsidian. Manually hunting through files to update dates is tedious and error-prone. The problem spans the entire vault — not just recent daily notes.

Decision

Add claude/skills/obsidian-todo-reschedule/ as a Claude Code skill that scans all .md files in the vault for incomplete - [ ] tasks with past 📅 dates and reschedules them in-place to today (or a specified target date).

  • Scans every .md file in the vault via Path.rglob("*.md")
  • Section-aware: skips Habit, Tech News, Energy allocation, Completed today
  • Dry-run by default — shows old vs new for each task before writing
  • --apply flag writes changes; --date and --vault flags for flexibility
  • Installed at ~/.claude/skills/obsidian-todo-reschedule/ for global use
  • Auto-approved in ~/.dippy/config so Claude can run without prompting

Alternatives Considered

Option Why Rejected
Obsidian plugin (Tasks / Dataview) Would reschedule on open — no preview, no control over which tasks move
Scan only last N daily notes Misses tasks in project files and older daily notes with future-dated schedules
Manual date updates Too slow; same cognitive overhead as the problem being solved

Consequences

Positive:

  • One command clears all overdue todos across the entire vault
  • Dry-run preview gives full control before any file is touched
  • Works on project files and archived notes, not just daily notes
  • No Obsidian plugin dependencies — pure Python, stdlib only

Negative / Trade-offs:

  • Vault path is hardcoded (/Users/phazeight/Documents/LifeOs) — not portable without editing
  • Scans all .md files including templates; bare placeholder tasks in templates can get updated (acceptable, low frequency)
  • No undo — changes are written directly to source files (Obsidian sync + git are the safety net)

Ongoing obligations:

  • Re-run when Obsidian calendar view shows a backlog of overdue tasks
  • Update VAULT_ROOT constant if vault moves

ADRs are immutable. If this decision changes, create a new ADR with status "Superseded by" pointing here, and update this record's status.