Obsidian TaskNotes Extension

A PowerToys Run Command Palette extension that integrates with the TaskNotes Obsidian plugin to manage tasks directly from your desktop.

Features

• View Tasks — Browse active, completed, and archived tasks with priority and due date badges
• Quick Actions — Complete, archive, or delete tasks without leaving the command palette
• Time Tracking — Start/stop time tracking sessions on tasks
• Pomodoro Timer — Run focused work sessions with built-in pomodoro support
• Statistics — View task completion stats and time tracking summaries
• Rich UI — Colored tags for priority, due dates, projects, and custom labels

Prerequisites

• Windows 10/11 with PowerToys installed
• Obsidian with the TaskNotes plugin configured
• TaskNotes HTTP API enabled in your vault
• .NET 9 SDK (for building from source)

Installation

From Release

1. Download the latest .msix package from Releases
2. Double-click to install
3. Open PowerToys Command Palette and search for "Obsidian"

From Source

# Clone the repository
git clone https://github.com/HeyItsGilbert/ObsidianTaskNotesExtension.git
cd ObsidianTaskNotesExtension

# Build and package
./build.ps1 Release

Building

This project uses psake for build automation via build.ps1.

Quick Start

# First time setup - install build dependencies
./build.ps1 -Bootstrap

# Build (Debug)
./build.ps1

# Build Release
./build.ps1 BuildRelease

# Full release pipeline (clean, build, test, package)
./build.ps1 Release

Available Tasks

Task	Description
Build	Build Debug configuration (default)
BuildRelease	Build Release configuration
Clean	Remove all build artifacts
Restore	Restore NuGet packages
Publish	Publish for x64 and ARM64
PackageMsix	Create MSIX installer
Test	Run unit tests
Analyze	Run code analysis
Format	Format code with dotnet format
Watch	Rebuild on file changes
CI	Full CI pipeline
Release	Complete release pipeline

# List all available tasks
./build.ps1 -Help

Development Workflow

# Watch mode - auto-rebuild on changes
./build.ps1 Watch

# Run CI checks before committing
./build.ps1 CI

Configuration

After installation, open the extension settings in PowerToys to configure:

• API URL — TaskNotes HTTP API endpoint (default: http://localhost:27124)
• Auth Token — Bearer token for API authentication (if enabled)

Usage

1. Open PowerToys Command Palette (Alt + Space by default)
2. Type Obsidian or Tasks to see available commands
3. Use the following entry points:
   • Tasks — View and manage active tasks
   • All Tasks — View all tasks including completed/archived
   • Pomodoro — Start focus sessions
   • Time Tracking — View active timers and summaries
   • Statistics — Task and time tracking stats

Project Structure

ObsidianTaskNotesExtension/
├── Commands/       # Command implementations (toggle, archive, delete, etc.)
├── Helpers/        # Tag and UI helper utilities
├── Models/         # Data models for TaskNotes API
├── Pages/          # Command Palette page implementations
├── Services/       # API client and settings manager
└── Assets/         # Icons and resources

Resources

• TaskNotes HTTP API Documentation
• PowerToys Command Palette Extensibility
• psake Build Tool

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Acknowledgments

• Icon by Freepik on Flaticon