pi-vaultify

A pi extension command that turns the current session into a connected Obsidian learning set inside your vault.

Install

pi install npm:pi-vaultify

Or load locally while testing:

pi -e ./index.ts

Command

/vaultify
/vaultify <topic hint>

What it does

• First looks for ~/.pi/agent/vaultify.json
• If that config exists, it uses vaultPath
• If not, it auto-finds Coding-Obsidian-Vault on your Desktop
• If the vault is missing, it notifies you and stops
• If found, it sends the current session digest to the agent
• The agent is instructed to create a course/wiki-style note set
• It follows your vault style: short notes, linked notes, START HERE / Index flow, practical examples, gotchas, and related links

Style notes

The command nudges the agent to read these notes first:

• START HERE.md
• Index.md
• AI Harness.md
• Architecture Overview.md
• Event Flow Diagram.md
• Agent Types.md
• Safety & Control.md
• Contributing Tasks.md

Configuration

Create ~/.pi/agent/vaultify.json:

{
  "vaultPath": "C:/Users/user/Desktop/Coding-Obsidian-Vault"
}

If the file is missing, the extension falls back to the Desktop vault path automatically.

Behavior

• If pi is idle, the command sends the vaultify prompt immediately
• If pi is busy, it queues the request as a follow-up
• The prompt asks the agent to write the notes into the vault and report the files created or updated

GitHub Actions

This package includes .github/workflows/publish.yml to auto-publish on v* tags.

One-time setup

1. Create an npm automation token with publish access.
2. Add it to GitHub Secrets as NPM_TOKEN.
3. Make sure the package name pi-vaultify is available in your npm account.

Release

npm version patch
git push
git push --tags

You can also use minor or major instead of patch.