obsidian-forge — Obsidian Vault Automation

obsidian-forge

Single binary vault generator and automation daemon.

Quickstart

Install

Install via cargo-binstall, crates.io, or build from source. Installs both obsidian-forge and of (short alias).

# Pre-built binary (fastest)
cargo binstall obsidian-forge

# Build from source
cargo install obsidian-forge

Initialize a Vault

Scaffolds a new Obsidian vault with PARA layout, templates, .obsidian config, and git init.

of init ~/my-vault
# → Creates PARA structure, templates, .obsidian config
# → Initializes git repository

Core Concepts

Vault Scaffolding

Generates a complete PARA (Projects, Areas, Resources, Archive) layout with bundled templates and .obsidian configuration. Idempotent — safe to run multiple times.

Graph Strengthening

Automatically adds backlinks, bridge notes, related-project links, and auto-tags to strengthen your knowledge graph connections.

Inbox Processing

Processes inbox notes with frontmatter injection, AI classification, and PARA routing. Supports Ollama, OpenAI, OpenRouter, LM Studio, and any OpenAI-compatible endpoint.

Background Daemon

Runs as a background daemon that watches your inbox, strengthens the knowledge graph, and syncs to git on a timer. Installs as a macOS LaunchAgent.

Reference

CLI Commands

Full command reference for vault management, operations, and daemon control.

of init                        # Scaffold new vault
of vault add/remove/list        # Multi-vault management
of vault enable/disable/pause   # Per-vault control

# One-off operations
of sync                        # Sync cycle (MOC + graph + git)
of update-mocs                 # Rebuild MOCs
of strengthen-graph            # Add backlinks + bridge notes
of process-all                 # Process inbox notes

# Daemon
of daemon install/uninstall    # macOS LaunchAgent
of daemon start/stop/status    # Lifecycle control

Configuration

vault.toml

Configuration is auto-created by init. Covers vault, graph, sync, AI, and daemon settings.

[vault]
name = "my-vault"
path = "~/my-vault"

[graph]
enabled = true
backlinks = true
bridge_notes = true

[sync]
auto_commit = true
interval_mins = 30

[ai]
provider = "ollama"  # ollama, openai, openrouter, lm-studio
model = "llama3"

[daemon]
enabled = true
watch_inbox = true

Examples

Knowledge Pipeline with Alcove

obsidian-forge organizes your knowledge graph, then promote notes into alcove for AI agent access.

# 1. Forge strengthens the graph
of strengthen-graph
of process-all
of sync

# 2. Promote a note to Alcove
alcove promote ~/my-vault/Projects/auth-notes.md

# 3. Agent searches the promoted doc
alcove search "authentication architecture"