Setup Guide
This guide walks through setting up the full Taskdn suite. It assumes you already have Obsidian and Claude Code installed.
-
Set up the starter vault
Clone the starter vault (it needs Obsidian 1.14 or later):
Terminal window git clone https://github.com/dannysmith/tdn-obsidian-starter-vault my-taskscd my-tasks./shift-dates.shrm -rf .git README.md shift-dates.sh./shift-dates.shis optional. It moves the example dates so they’re relative to today.In Obsidian, click Open folder as vault and choose the cloned folder. Bases, Templates and wikilinks are already set up.
Have a look around. The vault opens on
Start Here.md, a dashboard with today’s tasks, a task board and your active projects. TheOverview.mdfiles intasks/,projects/andareas/have more views.Optional: Folder Notes plugin
The Folder Notes plugin makes the Overview files open automatically when you click a folder. Install it from Community Plugins, set the folder note name to
Overview, then restart Obsidian. -
Install the Obsidian plugin
With your vault open in Obsidian, click this button to open Taskdn’s page in Obsidian’s plugin browser, then click Install and Enable:
Add to ObsidianIf the button doesn’t open Obsidian, go to Settings → Community plugins, turn on community plugins, click Browse and search for “Taskdn”. You can also install it manually.
In Settings → Taskdn, set Ignored files to
Overview.md. The default tasks directory,tasks, already matches the starter vault.Now open
example-note.mdin your vault to see task links rendered as interactive widgets. Click a checkbox to mark a task done. -
Install and configure the CLI
Install the CLI:
Terminal window brew tap dannysmith/taproom && brew install tdnCreate a config file pointing to your vault:
Terminal window tdn initTry it out:
Terminal window tdn contextYou should see an overview of your areas, projects, and tasks.
-
Install the Claude Code plugin
In Claude Code, install the plugin globally:
/plugin marketplace add dannysmith/taskdn/plugin install tdn@tdn-marketplaceTry asking Claude about your tasks:
/tdn:todayOr just ask naturally: “What’s on my plate this week?”
-
Install the desktop app
Once installed, point it at your vault directory and you’ll see your tasks in a proper task management UI.