| name | obsidian-forge |
| description | obsidian-forge (alias `of`) CLI skill for creating and managing Obsidian vaults, processing inbox notes with AI classification, strengthening knowledge graphs, syncing plugins across vaults, and running the background daemon. Use when initializing vaults, automating PARA routing, managing MOCs, or debugging vault sync and graph operations. |
obsidian-forge CLI (of)
Quick Start
of init my-vault --path ~/Documents
of vault add ~/Documents/my-vault
of daemon install
of vault list
of daemon status
Core Patterns
Diagnose before acting
Always run these first when user reports a problem:
of vault list
of settings status
of daemon status
RUST_LOG=debug of sync
Note processing (AI required)
of process-all [--vault <name>]
Reads Inbox/, calls AI provider, injects frontmatter, moves file to PARA folder.
AI provider must be configured in vault.toml [ai]. If it fails, read the error — unknown provider or missing base_url will have a clear message.
Graph + MOC (no AI needed)
of update-mocs [--vault <name>]
of strengthen-graph [--vault <name>]
of sync [--vault <name>]
All idempotent — safe to re-run.
Multi-vault plugin sync
of settings import <vault>
of settings push-all
Vault lifecycle
of vault disable/enable <name>
of vault pause/resume <name>
of vault remove <name>
Key Facts
- Config hierarchy:
vault.toml (per-vault) overrides nothing — it IS the source of truth
- PARA folders:
Inbox/ → 01-Projects/ 02-Areas/ 03-Resources/ 99-Archives/
- Daemon logs:
~/.obsidian-forge/logs/of/forge.log
graph.* bools in vault.toml gate each graph operation individually
