pi-obsidian

Pi package for reading, writing, visualizing, and managing projects in Obsidian vaults. Registers 13 tools that let pi interact with your knowledge base.

Features

Core

• Vault discovery — auto-detects vaults from Obsidian's config
• Read/write notes — with YAML frontmatter parsing
• Append to notes — for journals, logs, and meeting notes
• Search notes — by filename and content (uses ripgrep when available)

Knowledge Discovery

• Tag analysis — list all tags with usage counts across the vault
• Backlinks — find notes linking to a target via [[wikilinks]]

Visualization

• Mermaid diagrams — flowchart, gantt, sequence, class, mindmap, pie, timeline
• Canvas files — create Obsidian Canvas files with nodes and edges

Project Planning

• Kanban boards — create task boards with columns and tasks
• Project dashboards — goals, milestones, Gantt chart, Dataview queries
• Daily notes — default, meeting, and planning templates with frontmatter

Installation

pi install npm:pi-obsidian

Or from git:

pi install git:github.com/boofpackdev/pi-obsidian

Or try without installing:

pi -e npm:pi-obsidian

Prerequisites

• Obsidian installed with at least one vault configured
• Node.js >= 20.6.0

All 13 Tools

| Tool | Category | Purpose | |------|----------|---------| | obsidian_list_vaults | Core | List all discovered Obsidian vaults | | obsidian_list_notes | Core | List .md notes in a vault (tree view) | | obsidian_read | Core | Read a note with optional frontmatter parsing | | obsidian_write | Core | Create or overwrite a note | | obsidian_append | Core | Append content to a note | | obsidian_search | Core | Search by filename and/or content | | obsidian_list_tags | Discovery | List all tags with usage counts | | obsidian_list_backlinks | Discovery | Find notes linking to a target | | obsidian_create_mermaid | Visualization | Generate Mermaid diagrams (7 types) | | obsidian_create_canvas | Visualization | Create Canvas files with nodes & edges | | obsidian_create_kanban | Planning | Create Kanban board notes | | obsidian_create_project_dashboard | Planning | Project overview with Gantt + Dataview | | obsidian_create_daily_note | Planning | Structured daily notes (3 templates) |

Quick Examples

> List my Obsidian vaults
> Show all tags in my Work vault
> Create a project dashboard for "API Redesign"
> Make a Kanban board for my sprint
> Create today's daily note with the planning template
> Generate a Gantt chart for my milestones
> Create a Canvas showing the system architecture
> Find all backlinks to "Architecture Decision"

License

MIT