README file from
Githubdotpm
Project management inside Obsidian. Table, Gantt timeline and Kanban board views over plain Markdown notes.
Install | Quick start | Docs | Website | Changelog
English | 简体中文
Project tools keep the plan in one app and the thinking about it in another. dotpm keeps both in the vault. A project is a note, a task is a note, and the table, the timeline and the board are three ways of looking at the same files.
- Scheduling, not checkboxes. Tasks have start and due dates, dependencies drawn as arrows, and a Gantt timeline that moves dependents when a blocker slips.
- Tasks are full notes. Each has a body, backlinks, tags and properties, so search, the graph, templates and Dataview all work on them.
- Agents and scripts can work the board. A local HTTP and MCP server and a command line client edit the same notes the views do, so a coding agent can pick up a task, update it and close it.
- Nothing to sign up for. Projects sync with whatever already syncs the vault, and a project folder can be diffed and reviewed in git like any other code.
- Runs on desktop and mobile, and any view exports to one HTML file that opens without Obsidian.
Install
In Obsidian, open Settings > Community plugins > Browse, search for dotpm, install and enable it. Or open the listing directly.
Needs Obsidian 1.13 or newer. Works on desktop and mobile.
BRAT: install BRAT, choose Add beta plugin and enter dotpm/obsidian-pm.
Manual: download main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/project-manager/, then reload Obsidian and enable the plugin.
Quick start
- Click the timeline icon in the ribbon, or run dotpm: Open projects pane.
- Click New project, give it a name, and open it.
- Click Add task. Set a status, a due date, an assignee, whatever you need.
- Switch between Table, Timeline and Board from the last part of the path at the top of the view.
- Look in your vault. There is a
Projects/Your project.mdnote and aProjects/Your project_tasks/folder with one note per task.
Already have notes you want as tasks? Run dotpm: Import notes as tasks. To turn an existing note into a project, add pm-project: true to its properties and run dotpm: Open current file as project.
Views
Table
Rows sort, filter and edit inline. A multi-row selection changes status, priority, assignee, tags, due date or parent for all of them at once. A filter and sort combination can be saved as a named view.
Timeline
Dragging a bar reschedules the task, dragging its edge changes the duration, and dragging from one bar to another adds a dependency. The scale zooms from days to years and is kept per view. Milestones are diamonds and a line marks today.
Board
One column per status, or per priority, assignee, tag, type or custom field. Dragging a card to another column changes that value, and columns can be reordered or hidden. Cards show priority, assignees, tags and due date.
Features
Tasks
- Subtasks to any depth
- Dependencies, within a project or across projects, and milestones
- Start and due dates, progress, assignees, tags
- Recurring tasks
- Time estimates and time logs
- Custom fields: text, number, date, select, multi-select, person, checkbox, URL
- A Markdown body on every task
Planning
- Auto-scheduling: dependents move when a blocker moves
- Due date reminders
- Archive, by hand or automatically after a set number of days
- Undo and redo
Organizing
- Sub-projects, with an overview page per project: progress, milestones, sub-projects, properties
- One view over a project, its subtree, a folder, the whole vault, or projects picked by hand
- Archive a project that is done or no longer relevant; its sub-projects go with it
- Filters on any field, custom fields included: is, is not, contains, between, date buckets and ranges
- Saved views: named filter and sort combinations, one of them starred as the view a project opens with
- Sort by up to three keys in the table and on the board
- Bulk edit from the table
- A project list you can search, filter by progress or tag, sort, group by folder or tag, and save views of
- People notes for assignees, with a per-person task list and an avatar color set by the note's
colorproperty
Customizing
- Statuses and priorities with label, color and icon, global or per project
- Per-project overrides for default view, scheduling and archiving
- Team members, global and per project
File format
A task looks like this. Open it in Obsidian, edit it in any text editor, or diff it in git.
---
pm-task: true
projectId: '[[Website redesign]]'
title: 'Write the launch post'
type: 'task'
status: 'in-progress'
priority: 'high'
start: '2026-09-01'
due: '2026-09-20'
progress: 40
assignees: ['[[Alice]]']
tags: ['marketing']
dependencies: ['[[Design the homepage]]']
---
Draft, review with the team, publish on launch day.
Sync works the way it does for any other note. Obsidian Sync, iCloud, Syncthing and git all carry projects along. Two people editing the same task at the same moment produce an ordinary sync conflict, and there is no real-time collaboration beyond that.
Outside Obsidian
Share a view. dotpm: Export current view as HTML writes the open table, timeline or board to a single file that opens in any browser, with the tasks, the filter and the icons inside it.
Local API and MCP. Turn on Settings > Local API and the desktop app serves the vault's projects on 127.0.0.1 with a bearer token. Scripts use plain HTTP; coding agents connect over the Model Context Protocol:
claude mcp add --transport http dotpm http://127.0.0.1:<port>/mcp --header "Authorization: Bearer <token>"
Command line. npm install -g @dotpm/cli installs the dotpm command. Run inside the vault folder, it finds the server on its own.
dotpm projects
dotpm create <projectId> --title "Write the release notes" --due 2026-09-20
dotpm search release --status todo
Everything a client changes goes through the same code the views use and shows up in Obsidian at once. See docs/api.md and docs/cli.md.
TaskNotes. dotpm imports TaskNotes tasks with their dates, dependencies and hierarchy, and can share statuses and priorities with it. See docs/tasknotes.md.
Contributing
Bug reports and feature requests go in issues. Pull requests are welcome. For anything larger than a fix, open an issue first so the approach can be agreed on before the work is done.
The repo is a pnpm workspace on Node 24. pnpm dev builds into the vault named by VAULT_PATH, and pnpm check, pnpm check:submission and pnpm test are what CI runs.