omp packages

pi-obsidian0.2.3

Pi package for Obsidian vaults — read, write, search, visualize (Mermaid, Canvas), and plan projects (Kanban, dashboards, daily notes). 13 tools.

boofpackdev Published 5 months ago MIT ~391 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

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