Folio
One folder, shared with your AI agent

A notebook as rich as your ideas.

Plain .md and .html files on your own disk — no account, no lock-in. Calm text when you want it; a real table, diagram, or living chart when an idea needs more.

Free & open source · macOS, Windows & Linux · your files never leave your disk

~/notes

rich note · growth.html

Notes added each week

Six weeks in, the habit is compounding. The chart below is drawn from numbers right in the note — none of it can live in a plain-text file.

W1W2W3W4W5W6
← weekly-review.md← the-graph.html2 backlinks

Plays well with everything you already use

Claude CodeMarkdownGitYour editorFinder & ExplorerPlain HTML
How it works

Three steps. Then it's just writing.

There's no onboarding wizard and no settings to wire up. The whole product is a folder, a few good ideas about links, and an open door for your agent.

01

Open a folder

Point Folio at any folder — or make a new one. Every note becomes a plain .md or .html file inside it. No account, no import, nothing to sync.

02

Write, and link

Type. Link one note to another with a normal relative link. Backlinks, a full-text index, and a navigable graph build themselves as you go.

03

Point your agent at it

Run a coding agent like Claude Code in the same folder. It reads and writes the exact same notes you do — no API key, no plugin, no setup.

No lock-in

It’s just a folder on your computer.

Your whole notebook is one folder of files, right where you can see them in Finder or Explorer. Because it’s just files, your AI agent can work the same folder — point Claude Code at it and it reads and writes your notes directly.

  • Back it up by copying the folder. Take it anywhere.
  • Open it in this app, your editor, or anything else.
  • The app and the agent are two programs on one folder.
Youread · writeYour notes.md & .html filesYour agentread · writenothing to wire up — one folder, two programs
The folder is the only “integration.”
What's inside

A calm writing app with a serious engine underneath.

Everything here follows your files. Nothing to maintain, nothing to configure — it's all just there, the moment you start writing.

Local files, no lock-in

Every note is a plain .md or .html file in one folder. Yours forever — copy it, sync it, version it with git, take it anywhere.

Plain → rich, automatically

Markdown by default. The moment a note needs a table, diagram, or chart, it just becomes HTML — no setting to flip.

Links, backlinks & a graph

Relative links build a navigable map and backlinks for free — they simply follow the links you write.

Built for your agent

An Agent panel surfaces the files that shape behavior — CLAUDE.md, AGENTS.md, writing-guide.md — to see and edit in one place.

Per-note history

Every change is recorded. Diff and revert any note, and see what you changed versus what your agent did.

Full-text search

Find any note instantly — plain or rich, body and titles. No index to maintain; it follows your files.

When a note wants to be more

You never choose a format. A note becomes as rich as its content needs.

A thought, a journal entry, meeting takeawaysOverkill
A few headings and links between ideasAlso fine
A real comparison with rows and columnsAn actual table
A diagram or a flow you can seeThe real thing
A chart drawn from live numbersRight there

That last row is the real difference. As AI agents grow more capable, the tables, typed data, and diagrams in a note become something they can reason over, not just read.

Working with your AI agent

Connecting an agent is just pointing it at the folder.

No API key to paste in, no plugin to install, no service to sign into. A coding agent like Claude Code already knows how to read and write files. Run it in the same folder as your notes, and now it can:

  • Read any note to answer a question or pull context.
  • Write a new note, or edit and restructure an existing one.
  • Tidy links, summarize a cluster, or draft from scattered thoughts.
$cd ~/notes && claude
notenotenoteagentnew note
Your notes feed the agent as context; it writes back a richer one.
WelcomeGetting startedYour agentThe graphRich notes
Hover a note to light its connections.
Links, the graph & backlinks

A single note is useful. A web of them earns its keep.

A link is just a normal relative link to another note. Make one and three quiet things happen at once: it becomes a path you can follow, an edge in the graph, and a backlink on the note you pointed at — so that note knows what mentions it.

Your notes, on your disk, ready for your agent.

Free and open source. Download it, open a folder, and start writing — nothing to sign up for.

View the project on GitHub