---

Tasks Map is a minimal Obsidian plugin that visualizes your - [ ] tasks as an interactive graph. Each task is represented as a node, with edges showing relationships based on special emoji/link syntax in your task text as implemented in the popular Tasks plugin.

Pre-requisites

• Required: You must have both the Dataview plugin and the Tasks plugin installed and enabled in your vault.

Features

• Graph Visualization: See all your Dataview tasks as draggable nodes in a React Flow graph.
• Custom Nodes: Each node displays task summary, tags, priority emoji, and completion status (color-coded).
• Task Relationships: Edges are created based on special emoji/link syntax (🆔 for outgoing, ⛔ for incoming, with hashes).
• Edge Management: Select and delete edges (removes the hash from both tasks/files).
• Tag Filtering: Filter visible tasks by tag using a multi-select dropdown overlay.
• Quick Navigation: Open the linked file for any task directly from the node.
• Task Completion: Mark tasks as completed/incomplete directly from the graph.
• UI Overlays: Modern overlays for tag filtering and reloading tasks.
• Priority & Emoji Support: Priority emoji (🔺, ⏫, 🔼, 🔽, ⏬) and robust emoji rendering.
• Automatic Layout: Uses dagre for clean, readable graph layouts.

Examples

Installation

Install through the Obsidian plugin manager: https://obsidian.md/plugins?id=tasks-map

Local installation

1. Clone or Download: Place the plugin folder in your vault's .obsidian/plugins/tasks-map/ directory.
2. Install Dependencies:

   npm install

3. Build the Plugin:

   npm run build

4. Enable in Obsidian:
   • Open Obsidian settings → Community plugins → Enable "Tasks Map".

Usage

• Open the "Tasks Map" view from the ribbon or command palette.
• Drag nodes to rearrange tasks visually.
• Click the checkmark to mark a task as completed/incomplete.
• Click the link icon to open the task's file.
• Select and delete edges to remove task relationships.
• Use the tag filter overlay to focus your view.

Development

• Dev Mode:

  npm run dev

• Build:

  npm run build

• Lint:

  npm run lint

Contributing

Pull requests and suggestions are welcome! Please open an issue or PR on GitHub.

License

MIT

API Documentation

See Obsidian API Docs