
# Synapse
**The second brain that organizes itself.**
Talk to it. It files, links, plans and reviews — in plain Markdown files you own,
on the AI subscription you already pay for, drawn as a living map of your mind.
**English** · [فارسی](README.fa.md)
[](LICENSE)



-f59e0b)
[Get started](#get-started) · [How it works](#how-it-works) · [Features](#features) · [Privacy](#privacy-and-security) · [FAQ](#faq) · [Contributing](#contributing)
## What is Synapse?
Synapse is an AI-native second brain and life OS. Your notes, ideas, tasks, projects, goals, habits, people and journal live as a folder of Markdown files on your own disk. You never have to sort them: you say what is on your mind — in a sentence, in Persian or English — and a brain files it as the right kind of item, links it to what it belongs to, and keeps the whole picture current. You see that picture as a living map, and every day the brain tells you what deserves your time.
The brain is not a service we run. It is **your own AI subscription**: Synapse starts the official, unmodified command-line app you are already signed in to (Claude Code or OpenAI Codex) with your vault as its working folder. No API keys to buy, no account with us, and Synapse never sees your credentials.
## Why?
Second brains rarely die from a lack of features. They die from upkeep. Folders, tags, templates and links are work, and the moment life gets busy the system falls behind and is abandoned. Tools like Obsidian give you total control and total responsibility; AI note apps take the work away and your files with it.
Synapse is built on a different bet: **the AI does the filing, you keep the files.**
- **Yours.** A plain folder of Markdown with YAML frontmatter and `[[wikilinks]]`. Obsidian opens it; any editor can read it; it outlives this app.
- **Effortless.** Capture in one sentence. The brain decides the kind, the category, the links, the due date.
- **Reversible.** Every brain run is a git commit in your vault. One click undoes it.
- **Private.** Local-first. Nothing leaves your machine except what the brain you chose reads to answer you. On a Mac the whole vault sits in an AES-256 encrypted disk opened with your password or Touch ID.
- **Independent.** Your subscription, your engine, your choice of model and effort — switchable at any time.
## How it works
```mermaid
flowchart LR
you([You: “Call Sara on Friday about the site”]) --> app[Synapse app]
app -->|starts, headless, cwd = vault| cli[Your own CLI