Solipsist documentation
Solipsist is a markdown editor for the .md files in a folder you already have. It has AI agents built in, but they
only suggest changes and never edit the page themselves. You ask for something at the cursor or about a selection,
an agent works on it in the background, and the result shows up in the page as a suggestion. You can accept it, reject
it, ask again, or chat about it.

Three things are always true:
- Your files only change when you say so. You work on copies in
.solipsist/, and Sync to file writes back only what you changed. - Agents don’t edit the page. Everything they do shows up as a suggestion. The one exception is a result you turn into a button yourself.
- Nothing leaves your machine except what a request needs, and that only goes to the model you connect. No analytics, no telemetry, no update check.
Install and runBun, one clone, and a folder of notes.
Connect a modelAn OpenRouter key, or a login you saved in Pi.
Your first requestAsk, wait, decide. The whole loop in two minutes.
EnginesPi, OpenRouter and models on your own computer: what each needs and costs.
For AI agentsPut requests in a file, drive a headless server, read the docs as markdown.
ConfigurationEvery setting, its default and where you can set it.
For Solipsist 0.1