Skip to content

Commands Reference

The /wiki slash command tree. All commands are registered by pi-vault-mind and available from any pi session.

Quick reference

Command Purpose
/wiki help Show this help
/wiki setup Interactive global config wizard (vault, embedding)
/wiki init Scaffold project config + collections
/wiki validate Health check LanceDB, config, and all collection paths
/wiki approve [collection] Batch-review pending entries
/wiki settings Open interactive settings dashboard
/wiki audit Audit config for missing defaults
/wiki reindex Rebuild FTS + vector indexes (--all, --reembed)
/wiki collection select Select active collection (shortcut: ctrl+alt+l)
/wiki collection create Interactive wizard to create a new collection
/wiki injector create Interactive wizard to create a new injector
/wiki context enable \| disable Enable/disable pi-context integration
/wiki context status Show pi-context integration status
/wiki embedding status Show embedding config + Ollama models
/wiki embedding use Switch provider (ollama | transformers)
/wiki embedding model Set Ollama embedding model
/wiki embedding models List available Ollama models
/wiki embedding pull Pull a model from Ollama
/wiki watcher start Start passive file watcher
/wiki watcher stop Stop passive file watcher
/wiki watcher status Show watcher status
/wiki server status Show HTTP server health and port

Setup & init

/wiki setup

The interactive global config wizard. Walks through:

  1. Vault path — absolute path to your Obsidian vault
  2. Embedding provider — transformers (zero-setup, downloads all-MiniLM-L6-v2 once) or ollama (higher quality, requires Ollama running)
  3. Ollama model — if you chose ollama, which embedding model to use (default: embeddinggemma)

Config is written to ~/.pi/agent/vault-mind.config.json and applies globally — no matter which project directory you open pi from.

CLI mode (for scripting or headless setup):

/wiki setup --vault /home/you/Obsidian/MyVault --provider transformers
/wiki setup --vault /home/you/Obsidian/MyVault --provider ollama --model embeddinggemma

/wiki init

Scaffold a project-local config (./pi-vault-mind.config.json) with default collections and injectors. The project config merges on top of the global config.

/wiki validate

Health check: verifies LanceDB connection, config schema, and all collection file paths. Prints a green/red report.

Watcher

/wiki watcher start

Start the passive file watcher. The watcher monitors every vault in wiki.vaults for @agent-* markers and dispatches subagent tasks.

Auto-starts on extension load if wiki.vaults is configured.

/wiki watcher stop

Stop the watcher. The watcher will not detect new markers until restarted.

/wiki watcher status

Show current watcher state: running, configured vaults, recent dispatches, and any errors.

/wiki server status

Show the HTTP server state: running/stopped, port, bind address, uptime, and available endpoints. The server auto-starts when the vault-mind extension loads and is used by the obsidian-shellcommands plugin to notify pi of file saves.

Embedding

/wiki embedding status

Show current embedding config: provider, model, dimensions, and (for Ollama) a connectivity check.

/wiki embedding use <provider>

Switch provider. Valid values: ollama, transformers.

/wiki embedding model <name>

Set the Ollama embedding model (e.g. embeddinggemma).

/wiki embedding models

List models available in your local Ollama installation.

/wiki embedding pull <model>

Pull a model from the Ollama registry. Use this the first time you set up Ollama embeddings.

Collection management

/wiki collection select

Open a TUI SelectList to interactively switch the active collection. Bound to ctrl+alt+l.

/wiki collection create

Interactive wizard to create a new collection. Prompts for:

  • Name
  • File path
  • Schema (field list)
  • Dedup field (for autopilot mode)

/wiki injector create

Interactive wizard to create a new regex-based injector. Prompts for:

  • Name
  • Regex pattern
  • Source collection
  • Filter field
  • Optional artifact path

HITL & approval

/wiki approve [collection]

Batch-review entries in the pending collection (or the specified collection if given). Each entry is shown in a confirm dialog:

  • Approve → moved to its _promotion_target (or the active collection).
  • Reject → stays in pending (or is removed, configurable).

Prints a final count: Approved 4 → 'main'. Rejected 1.

Maintenance

/wiki reindex

Rebuild the FTS (Tantivy) and vector indexes. Use after bulk imports or embedding provider changes.

  • /wiki reindex — reindex all collections
  • /wiki reindex --all — force a full reindex (including re-embedding every entry)
  • /wiki reindex --reembed — re-embed entries using the current provider

/wiki audit

Audit your config for missing defaults: required fields, common typos, broken collection paths. Suggests fixes.

Context integration

/wiki context enable

Enable the pi-context integration. Sets extensionCompatibility.pi-context.enabled = true.

/wiki context disable

Disable the pi-context integration.

/wiki context status

Show whether pi-context is installed, enabled, and currently active.

Settings dashboard

/wiki settings

Open the interactive TUI settings dashboard. Visually manage collections, injectors, embedding provider, and extension integrations.

See also