Private mode

On this page

Private mode runs notegraph on your own computer, with no notegraph server and no account. It is for people at home in a terminal. Everyone else should use the connector.

A standalone vault that syncs end-to-end encrypted across your machines, through a bucket you own. Import your Obsidian vault in one command.

Start here#

Your notes live on your own computer, as plain text. You connect an AI app, such as Claude Code or Claude Desktop, and ask it in your own words to find, add or change notes. notegraph keeps a record of each change, and you undo the ones you do not want. There are two ways to set it up.

With your AI#

If your AI assistant can run commands on your computer, it can do the setup. Copy this sentence and paste it to your assistant.

Paste this to your AI assistant

Read https://notegraph.sh/docs/private-mode/ai-setup/ and set up notegraph for me. Follow the steps on that page exactly. When you finish, tell me what you did and what I have to do myself.

It sends your assistant to a setup guide written for it. Today the guide tells it that notegraph is not released yet, and to stop there.

Yourself#

How the pieces fit#

The core is one program. It keeps your notes and their full history in a local store, and it runs the terminal commands (log, show, revert, sync and the rest). The MCP server is a thin layer on top. Your agent starts it with notegraph mcp, and it offers sixteen tools. There is no notegraph server and no account.

Use#

Reference#

About#

Words used in these docs#

AI assistant, or agent
An AI app that can do things for you, such as Claude Code or Claude Desktop. The docs say agent where the app acts by itself.
MCP
The Model Context Protocol: the standard way an AI app connects to a tool. notegraph is such a tool, and your AI app is the MCP client.
Vault
The place on your computer where notegraph keeps your notes and the full history of their changes.
Terminal
The window where you type commands. On a Mac it is the app called Terminal.
Markdown
Plain text with a few marks, such as # for a heading. Your notes stay in this form, so any editor can read them.
Change, and the log
Each time a note is written, notegraph records a change: what, who, when and on which computer. The log is the list of changes.
Revert
To undo a change. The old text comes back, and the undo is recorded as a change too.
Sync
Keeping the same notes on all your computers. It is off until you turn it on.
Bucket
Storage space that you rent from a cloud company, such as Cloudflare R2. Sync puts your notes there in locked form, so the company cannot read them.
Denied folder
A folder that you hide from every AI assistant. The tools cannot read it, write it or find it in a search.