Support

Help and answers about Loam.

Getting Started

Using Loam is straightforward:

  1. Open a folder: Point Loam at any directory of markdown files, or click Try a Sample to see it in action immediately — no setup needed.
  2. Point your AI at it: Let Claude Code, Cursor, or any agent read and write to that same folder. Loam watches quietly in the background.
  3. Review changes: Come back to Loam to see a clear summary and structured diff of everything your agent touched. Accept or reject changes file by file.
  4. Close the loop (Pro): Record why you rejected changes. Your agent can query that feedback back over MCP — so your corrections stay visible to it.

That's it. No git required. No migration. No import. Just files.

Frequently Asked Questions

Do I need an API key?

Only for the "Catch me up" feature, which generates an AI summary of all changes across your folder. This is optional. The core review, diff, and accept/reject flow works entirely offline. Your API key is stored securely in macOS Keychain and is never logged to disk.

Does it work with Obsidian vaults?

Yes. Loam understands real Obsidian vaults — point it at any vault and it reads wikilinks ([[note]], [[note|alias]], [[note#heading]]), resolves them vault-wide using Obsidian semantics, and understands backlinks. The .obsidian/ folder is left untouched. Loam sits alongside Obsidian as your review layer, not a replacement.

Does it need git?

No. Loam keeps its own git-independent snapshot of a folder's state, so the "since you last looked" review works on any directory of markdown — with or without version control.

Where is my data?

All local. Loam stores snapshots, feedback logs, and history in ~/Library/Application Support/Loam/. Your markdown files stay in the folders you choose. See the privacy policy for full details.

What's Free vs Pro?

  • Free: Review changes, structured diff, accept/reject per file, AI vs you provenance filter, Obsidian support, markdown editor, six themes.
  • Pro (one-time purchase): Everything in Free, plus append-only history, .dream-log.md export, Memory Health panel, MCP feedback loop tools, per-folder review rules.

How do I set up the MCP server?

The MCP server is a small, read-only, local command-line tool called loam-mcp. It lets an AI agent on your Mac ask Loam what changed in a folder, see the diff, read a document's context, and — with Pro — read the history and what you rejected and why. It never writes, uploads, or changes anything.

Direct-download version: it's bundled inside the app. Register it with Claude Code like this:

claude mcp add loam -- /Applications/Loam.app/Contents/Resources/loam-mcp

Mac App Store version: the tool isn't included in the App Store build. It's available as a separate free download — link coming to this page.

How do I export my data?

Pro includes a .dream-log.md export of your append-only change history. Use the app's export button in the History panel. For all other data (feedback logs, snapshots), you can access the raw files directly in ~/Library/Application Support/Loam/.

What if I want to delete my data?

Delete all Loam data by:

  1. Delete ~/Library/Application Support/Loam/ to remove all snapshots, feedback logs, and history.
  2. Delete or revert the markdown files in your chosen folders (Loam does not manage your files).
  3. Uninstall Loam.

System Requirements

  • macOS: 14 (Sonoma) or later
  • Processor: Apple Silicon or Intel

Contact

Questions, bug reports, or feedback?

Email: jbindiehacker@gmail.com">jbindiehacker@gmail.com

Need More Help?

For additional information, check the FAQ on the main site or the privacy policy for details on data and security.