forge-me-notes 0.2.0

An LLM-assisted workflow tool for Obsidian vaults.

forge-me-notes (fmn)

An LLM-assisted workflow tool for Obsidian vaults.

fmn is a minimal CLI that bridges Obsidian and an LLM chat session. It packs your vault into a context file, you hand that to an LLM, the LLM produces structured notes, and fmn writes them back into the vault — cleanly, non-destructively, and with a dry-run by default.

---

Command status

Command	Status
fmn	done
fmn config	done
fmn init	done
fmn pack	done
fmn write	done

---

Quick Start

Install

pip install forge-me-notes

Configure your vault

fmn config --vault ~/vaults/my-vault

Scaffold the vault (copies templates and the session prompt into the vault)

fmn init

Pack the vault (produces a context file to upload to your LLM)

fmn pack

Write notes back (dry run by default — review before applying)

fmn write notes.yaml
fmn write notes.yaml --apply

---

How it works

1. fmn pack scans your vault and writes a context pack.
2. You upload the context pack to an LLM chat session and have a conversation.
3. The LLM produces a notes.yaml file following your vault's schema.
4. fmn write notes.yaml validates and applies the notes to your vault.

fmn never deletes content. create skips existing files unless --force is passed. update merges frontmatter and preserves body content unless a new body is provided.

---

Living documentation

Full documentation is maintained in the fmn-docs repository — a live Obsidian vault kept up to date by fmn itself.

---

Regression suite

bash tests/regression/run_regression.sh

Wipes and rebuilds tests/regression/vault/ from fixtures. Open that folder in Obsidian to inspect results.

---

License

MIT — see LICENSE.