Integrations

note.md + Claude Cowork

Cowork runs Claude in the cloud and connects to folders on your Mac. Connect your vault, and everything Claude produces becomes something you can read, mark, and keep.

Why this pairing works

Cowork's deliverables are overwhelmingly markdown: research reports, plans, specs, drafts. By default they scatter — a download here, a conversation attachment there. Point Cowork at your note.md vault instead, and its output lands where your reading loop lives: every report gets a home, every read-through leaves a sidecar of judgment, and your next Cowork session can be told to read those sidecars first.

Setup

  1. In the Claude desktop app, connect your vault folder to the Cowork session ("Add folder").
  2. Add an AGENTS.md at the vault root (conventions summary: llms-full.txt) — Claude reads it automatically and follows the house rules.
  3. Ask Claude to save deliverables into the vault, e.g. research/2026-07-11-competitor-scan.md.
  4. Read them in note.md; your highlights and notes save to sidecar .note.md files.
  5. Next session, one line: "Read the .note.md sidecars for the reports you wrote last week and address my margins." The loop closes.

Tips

FAQ

Does Claude respect the vault conventions?

Yes, if you put them in an AGENTS.md at the folder root — Claude Code and Cowork read agent instruction files as standard practice.

Can Claude read my annotations?

That's the point. Sidecar .note.md files are plain markdown; ask any session to read them and it will see exactly what you highlighted and questioned.

Own your thinking.

Free. Open. A folder of markdown on your Mac.

Download for macOS