obsidian-pi-vault-mind
v0.1.0
Published
Vault Mind side panel for Obsidian — live queue, status, search, and chat for the pi-vault-mind extension.
Readme
Alpha — not yet in the Obsidian community-plugin store. Install via BRAT for now.
Vault Mind
A right-hand side panel for Obsidian that connects to the local
pi-vault-mind extension.
It gives you three dockable views:
- Vault Mind Queue — live list of pending / running / done / failed / cancelled agent dispatch jobs, with retry / cancel buttons.
- Vault Mind Status — pi running state, watcher toggle, embedding provider/model, and a search box.
- Vault Mind Chat — a chat surface that talks to
pidirectly via the existing RPC mode.
Requirements
- Obsidian 1.5.0+ desktop (Electron-based; mobile is not supported).
pi-vault-mindextension running in a localpisession (or headless).- A
PVM_API_TOKENconfigured in env,~/.pi/agent/vault-mind.env, or the extension config. The plugin imports the token from the dotenv file and seals it in the OS keychain via ElectronsafeStorage.
Install
Manual (alpha)
- Download
obsidian-pi-vault-mind.zipfrom the latest GitHub release. - Extract it into your vault:
<vault>/.obsidian/plugins/obsidian-pi-vault-mind/. - The folder must contain
main.js,styles.css,manifest.json, andversions.json. - Restart Obsidian, then enable Vault Mind in Settings → Community Plugins.
BRAT
- Install the
obsidian42-bratplugin and enable it. - Open BRAT settings → Add Beta plugin with frozen version.
- Enter the repository URL:
https://github.com/kylebrodeur/pi-vault-mind. - Pick the latest release that starts with
obsidian-v. BRAT will download theobsidian-pi-vault-mind.zipasset. - Enable Vault Mind in Settings → Community Plugins.
Usage
Open the command palette and choose one of:
Vault Mind: Open QueueVault Mind: Open StatusVault Mind: Open Chat
On first run, the plugin will prompt you to import the bearer token from
~/.pi/agent/vault-mind.env. It then connects to
http://127.0.0.1:11435 by default (configurable in settings) and opens the
setup wizard if the extension is not yet configured.
Development
# from repo root
pnpm install
pnpm --filter obsidian-pi-vault-mind dev # watch build
pnpm --filter obsidian-pi-vault-mind build # production buildProduction build outputs packages/obsidian/main.js, which Obsidian loads
from the plugin directory.
Attribution
- Plugin scaffold patterns inspired by
RAIT-09/obsidian-agent-client(Apache-2.0). - Chat view forked from
gengyabc/obsidian-pi-plugin(MIT). SeeTHIRD_PARTY_NOTICES.md.
License
MIT
