Obsidian Task Matrix ⚡

Visual task dashboards with list, GTD, and Eisenhower views.

✨ Features

🔄 Three Complementary Views

View	Best For	Key Benefit
📋 List View	Comprehensive task overview	Search and browse all tasks
📥 GTD Flow	Workflow management	Visual Kanban with Inbox → In Progress → Waiting → Done
🔳 Eisenhower Matrix	Priority decisions	Urgency vs. importance at a glance
🗓 Calendar View	Date planning	Review due, start, scheduled, and done tasks by month, week, or list

🎯 Core Capabilities

• Visual Task Dashboard: See all your vault's tasks in one place
• Smart Task Parsing: Supports standard Obsidian task formats including:
  • Task status: - [ ], - [/], - [-], - [x]
  • Priorities: ⏫ (Highest), 🔼 (High), 🔽 (Low), ⏬ (Lowest)
  • Dates: 📅 Due, 🛫 Start, ⏳ Scheduled, ✅ Done, ➕ Created
  • Task IDs: 🆔 for dependency tracking
  • Dependencies: ⛔ indicates a task is blocked by another
  • Tags: Any #tag including #waiting, #doing, #blocked

🧠 Smart Automation

• Auto GTD Classification: Tasks are automatically categorized based on status, tags, and dates
• Eisenhower Quadrants: Auto-sorted by priority and due date urgency
• Configurable Urgent Range: Set how many days count as "urgent" (1-7 days)
• Dependency Tracking: Blocked tasks (with unfinished dependencies) are visually marked
• Drag & Drop: Move tasks between GTD columns or Eisenhower quadrants to auto-update tags
• Quick Move Buttons: Move tasks directly between GTD states or Eisenhower quadrants from the task card
• Date Conflict Detection: Warns when a start date is later than a due date

🔍 Filtering & Navigation

• Keyword Search: Filter tasks by description, file path, task ID, or dependency ID
• Date Filters: Filter by Start date and Due date with on, before, after, is empty, is not empty, and more
• Calendar Summary: See scoped counts for due, overdue, start, scheduled, recurrence, and daily-note tasks
• Calendar Modes: Switch between month, week, and list layouts

🎛️ Task Actions

Each task card provides quick actions:

• ✓ Complete/Uncomplete (optionally adds ✅ YYYY-MM-DD when completing)
• ▶ Start (set to in-progress)
• ✕ Cancel
• ✎ Edit (modify description, priority, dates, ID, dependencies)
• 🗑 Delete
• Click to open task in file

📁 List View Features

• Folder Grouping: Group tasks by folder with configurable depth (1-5 levels)
• Expand/Collapse Groups: Toggle individual groups or expand/collapse all with one click
• Refreshed Styling: List groups now use a cleaner card style aligned with the calendar list view

📱 Mobile Experience

• Responsive Toolbar & Cards: Better spacing and stacking for small screens
• Responsive GTD Board: Single-column layout on mobile with collapse/expand support
• Mobile Matrix Collapse: Collapse Eisenhower quadrants by tapping the title (also available on desktop)
• Responsive Calendar Layouts: Improved month, week, and list browsing on smaller screens

⚙️ Settings

• Scan Folder: Limit task indexing to a specific vault folder
• Default View: Choose which view opens first (List/GTD/Eisenhower)
• Open Location: Open in sidebar or new tab
• Include Completed: Toggle visibility of completed/cancelled tasks
• Completion/Cancelled Markers: Customize checkbox markers for task states
• Track Completion Date: Auto-add ✅ YYYY-MM-DD when completing tasks
• Urgent Days Range: Set urgent threshold (1-7 days, default 1 = today only)
• Due Date Display Range: Hide tasks due farther than the selected number of months
• Hide Future Start Tasks: Hide tasks whose start date is more than one month away

List View Settings

• Group by Folder: Enable folder grouping
• Grouping Depth: How many folder levels to group by (1-5)

New Task Settings

• Target Note Path: Default location for new tasks (supports YYYY, MM, DD templates)
• Target Heading: Insert new tasks under a specific heading

📥 Installation

Using BRAT (Recommended for Beta Versions)

1. Install the BRAT plugin in Obsidian
2. Open BRAT settings and click "Add Beta plugin"
3. Enter: luna-jmy/obsidian-task-matrix
4. Click "Add Plugin" and enable it in Community Plugins

From GitHub Releases

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder named task-matrix under your vault's .obsidian/plugins/
3. Put the downloaded files into that folder
4. Enable "Task Matrix" in Obsidian Settings → Community Plugins

From Source

git clone https://github.com/luna-jmy/obsidian-task-matrix.git
cd obsidian-task-matrix/obsidian-task-matrix-plugin
npm install
npm run build

Copy the obsidian-task-matrix-plugin folder to your vault's .obsidian/plugins/ directory.

🚀 Usage

Opening the Task Matrix

• Click the kanban icon in the left ribbon
• Use the command palette: "Open task matrix"
• Set a hotkey for the "Open task matrix" command

Creating Tasks

Create tasks in any markdown file using standard Obsidian syntax:

- [ ] Review quarterly goals 📅 2025-03-15 🔼
- [/] Write blog post #doing 🛫 2025-03-10
- [ ] Waiting for feedback #waiting 🆔 task-123
- [ ] Implement feature ⛔ task-123
- [x] Completed task ✅ 2025-03-11

Task Dependencies

When editing a task, the "Depends On" field shows a dropdown of all incomplete tasks that have a task ID, sorted by due date (nearest first). This makes it easy to set up task dependencies without remembering task IDs.

Task Format Reference

Symbol	Meaning
- [ ]	Open task
- [/]	In progress
- [-]	Cancelled
- [x]	Completed
⏫	Highest priority
🔼	High priority
🔽	Low priority
⏬	Lowest priority
📅 YYYY-MM-DD	Due date
🛫 YYYY-MM-DD	Start date
⏳ YYYY-MM-DD	Scheduled date
🆔 task-id	Task identifier
⛔ task-id	Depends on task
✅ YYYY-MM-DD	Completion date (auto-added when "Track completion date" is enabled)

Drag & Drop

• GTD View: Drag tasks between columns to update their state

  • To "In Progress": Adds #doing tag
  • To "Waiting": Adds #waiting tag
  • To "Done": Marks as completed

• Eisenhower View: Drag tasks between quadrants to adjust priority and urgency

  • To Q1 (Important + Urgent): Sets high priority, adds due date
  • To Q2 (Important + Not Urgent): Sets high priority, clears due date
  • To Q3 (Urgent + Lower importance): Sets low priority, adds due date
  • To Q4 (Delegated or discard): Sets lowest priority, clears due date

Date Filters

Use the Date Filters control in the toolbar to narrow tasks by:

• Start date
• Due date

Supported operators:

• not on
• on
• before
• on or before
• after
• on or after
• is empty
• is not empty

🏗️ Tech Stack

• Obsidian API: Plugin framework
• TypeScript: Type-safe development
• esbuild: Fast bundling

📝 Changelog

See CHANGELOG.md for version history.

📣 Official Account

Follow my WeChat official account:

📄 License

MIT License

🤝 Contributing

Contributions welcome! Please open issues or submit pull requests.