MCPcopy Index your code
hub / github.com/ArctykDev/obsidian-project-planner

github.com/ArctykDev/obsidian-project-planner @v0.8.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.8.2 ↗ · + Follow
818 symbols 2,110 edges 32 files 91 documented · 11%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Obsidian Project Planner

Obsidian Release Build License

A full-featured project planner for Obsidian based on Microsoft Premium Planner.

Features

Views

  • Grid View — Hierarchical task table with parent/child subtasks, inline editing, drag-and-drop row reordering, and configurable columns
  • Board View — Kanban board with custom buckets, drag-and-drop cards, and collapsible completed sections
  • Timeline View — Gantt-style chart with resizable task bars, dependency arrows (FS/SS/FF/SF), and synchronized scrolling
  • Dashboard — Project KPIs, completion progress, priority/due-date alerts, effort summary, and budget/cost cards
  • Dependency Graph — Interactive node-based visualization of task dependencies with HiDPI canvas rendering
  • My Tasks — Cross-project aggregation of tasks due today (table mode) or this week (Outlook-style 7-day column layout)

Task Management

  • Task Detail Panel — Full editing of status, priority, dates, tags, links, description, subtask checklist, effort, cost, and dependencies
  • Custom statuses, priorities, and tags with configurable colors
  • Bucket assignment independent of task status
  • Task dependencies — Four types (Finish-to-Start, Start-to-Start, Finish-to-Finish, Start-to-Finish) with dependency-driven auto-scheduling
  • Parent task roll-up — Dates, effort, % complete, and cost automatically calculated from subtasks (MS Project style)
  • Deep links to tasks via Obsidian URI protocol

Effort Tracking

  • Microsoft Planner-style effort system — Completed hours, remaining hours, total, duration, and % complete
  • Smart auto-sync — Entering completed hours auto-deducts remaining; marking a task complete moves all remaining into completed
  • Effort columns in Grid View — % Complete, Effort Done, Effort Left, Effort Total, Duration (inline-editable)

Cost Tracking

  • Per-task cost — Fixed amount or hourly rate × effort hours
  • Project budget settings — Total budget, default hourly rate, and currency symbol per project
  • Grid View cost columns — Est. Cost and Actual Cost (toggleable)
  • Dashboard budget card — Progress bar with color thresholds (green → yellow → red), Estimated/Actual/Remaining KPIs
  • Cost Report modal — Breakdown by bucket, status, or priority with totals and variance; over-budget task list

Sync & Integration

  • Bidirectional markdown sync — Tasks sync to/from YAML frontmatter in markdown notes (status, dates, effort, tags, etc.)
  • Daily note task scanning — Tag tasks in daily notes (e.g., #planner) to automatically import them into projects
  • Project hub notes and task notes for Obsidian graph navigation

Grid View Extras

  • Column show/hide with checkmark menu
  • Drag-and-drop column reordering with persistent order
  • Column resizing with double-click auto-fit
  • Inline editing for titles, statuses, priorities, dates, effort, and tags
  • Right-click context menu — Add above/below, make subtask, promote, delete, open detail

Configuration

  • Multi-project support with project switcher in the header
  • Customizable ribbon icons — Toggle visibility of Grid, Dashboard, Board, Graph, and Daily Note Scan icons
  • Date format options — ISO, US, or UK
  • Per-view settings — Column widths, visibility, and sort order persist across sessions

Screen shots

Dashboard view [v0.7.0]

Dashboard

Grid view [v0.6.7]

Grid View

Board view [v0.6.7]

Board view

Timeline view [v0.7.0]

Timeline view

Dependency graph [v0.7.0]

Dependency graph

Task details - [v0.4.0]

Task Details

Plugin settings - [v0.4.0]

Plugin Settings

Documentation

Installation: How to install Obsidian Project Planner

Full documentation: Obsidian Project Planner Docs

Full changelog: Obsidian Project Planner Changlog

View the roadmap: Obsidian Project Planner Roadmap


Community

Discussion board: Discussions

Discord: Project Planner Discord Server

YouTube: Project Planner YouTube Channel


Support

Project Planner is free to use and enjoy, but you can help support the project by joining our community, sharing Project Planner with others, or by a small donation.

Buy Me A Coffee


ProjectPlanner.md

Official website: ProjectPlanner.md

Obsidian website: Obsidian.md

Extension points exported contracts — how you extend this code

ProjectPlannerData (Interface)
(no doc)
src/main.ts
BoardBucket (Interface)
(no doc)
src/settings.ts
PlannerStatus (Interface)
(no doc)
src/types.ts
ProjectCostSummary (Interface)
(no doc)
src/utils/costUtils.ts
StoredData (Interface)
(no doc)
src/stores/taskStore.ts
HeaderOptions (Interface)
(no doc)
src/ui/Header.ts
PlannerProject (Interface)
(no doc)
src/settings.ts
PlannerPriority (Interface)
(no doc)
src/types.ts

Core symbols most depended-on inside this repo

setName
called by 90
tests/__mocks__/obsidian.ts
addItem
called by 80
tests/__mocks__/obsidian.ts
setDesc
called by 66
tests/__mocks__/obsidian.ts
saveSettings
called by 54
main.js
updateTask
called by 53
main.js
saveSettings
called by 51
src/main.ts
load
called by 46
main.js
getAll
called by 44
main.js

Shape

Method 679
Class 74
Function 44
Interface 21

Languages

TypeScript100%

Modules by API surface

main.js357 symbols
tests/__mocks__/obsidian.ts73 symbols
src/ui/GridView.ts59 symbols
src/ui/TaskDetailView.ts41 symbols
src/ui/GanttView.ts41 symbols
src/stores/taskStore.ts38 symbols
src/ui/BoardView.ts37 symbols
src/ui/MyDayView.ts35 symbols
src/ui/DashboardView.ts24 symbols
src/main.ts24 symbols
src/ui/DependencyGraphView.ts22 symbols
src/utils/DailyNoteTaskScanner.ts19 symbols

For agents

$ claude mcp add obsidian-project-planner \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page