Getting Started¶

Pick the path that matches where you are:

New here?

Start with the Quickstart — install, configure, and run your first @agent marker in 60 seconds.

Quickstart
Need the full setup?

The Install Playbook covers all 5 layers (pi extension, skills, Obsidian plugins, config, external CLIs) with verification steps.

Install Playbook
End-to-end walkthrough

Once installed, End-to-End Walkthrough walks through the daily "drop & forget" workflow in 5 steps.

Walkthrough
Want a guided session?

Paste the Walkthrough Prompt into a fresh pi session for a checkpointed setup with safety prompts.

Guided prompt

Concepts to understand first¶

LanceDB — local embedded vector database. No external service, no API key. Stores embeddings for semantic search.
Pi subagents — the subagent() tool from pi-subagents. Lets the Manager fork isolated worker sessions (context: "fork") for the Miner, Broadcaster, etc.
@agent markers — a passive dispatch pattern. Drop @agent-Miner in any Obsidian note, save, the watcher fires.
JSONL WAL — append-only write-ahead log. pi-vault-mind writes durable JSONL, embeds into LanceDB, and extracts graph edges. Best of all worlds.

After setup, head to the Architecture section to understand the multi-agent model, then Reference for the full tool/command reference.