Subnotes for Claude Code
A plugin that lets Claude Code read the notebooks you choose to connect, and add tasks to them — so “let's put that on the backlog” lands in your notebook instead of dying with the conversation.
What it does
Ask what's on a notebook, or what to pick up next. Say “put that on the backlog” mid-conversation and it goes to the right notebook and the right section, without breaking your train of thought.
What you'd actually say
“Add a task to fix the login redirect.”
Lands in the notebook you're working in, under the section it belongs to.
“What's on the Kitchen Remodel notebook?”
Reads it back — tasks, sections and what's marked Next.
“We should handle the empty state too — put that on the backlog.”
Captured mid-conversation, without stopping to open an app.
Two rules it keeps
- It only ever adds. Nothing can be edited, deleted, completed, reordered or renamed. A write that only adds cannot lose work.
- Only notebooks you connect are visible. Everything else is never written out at all, so it can't be read — invisible, not merely hidden.
What you'll need
Subnotes 1.4 or later, on a Mac, and Claude Code.
Installing it
In Claude Code, add the marketplace and install the plugin:
/plugin marketplace add rafrafgit/subnotes-plugin
/plugin install subnotes@SubnotesThen give Claude Code Full Disk Access in System Settings → Privacy & Security → Full Disk Access, and restart it. macOS keeps one app’s files out of reach of another, so without it the plugin can see that the Subnotes folder exists but can’t open anything in it, and every command fails with a permission error.
Grant it to whichever app is actually running Claude Code — your terminal (Terminal, iTerm, Ghostty…), or the Claude desktop app. The grant doesn’t carry between apps, so running from a terminal you haven’t granted looks exactly like a plugin that stopped working on its own.
After that, just say it in any conversation — no command needed. Or run
/subnotes:help to see what's connected, and
/subnotes:add to capture something straight away.
Connecting your notebooks
Nothing is visible to Claude until you say so. Open Settings in Subnotes (⌘,) and turn on the notebooks you want Claude to see — or right-click a single notebook and choose Connect to Claude Code.
Nothing leaves your Mac. The plugin reads files Subnotes writes inside its own app container, and writes tasks back the same way — there is no account, no server and no network call.