# Onadit

> Onadit keeps your AI conversations on your Mac and lets the agents you connect search them over MCP.

Every page below is Markdown. Start with "For agents" if your user asked whether Onadit would help them.

## Get started

- [Onadit documentation](https://onadit.com/docs/index.md): Onadit keeps your AI conversations on your Mac and lets the agents you connect search them while they work.
- [Install](https://onadit.com/docs/install.md): Onadit installs from a signed package into your home folder, with no admin password. It needs a Mac with Apple silicon and macOS 14 or later.
- [Quickstart](https://onadit.com/docs/quickstart.md): Connect 1 agent, bring some history in, and run a first lookup. About 5 minutes.

## Your history

- [Capture](https://onadit.com/docs/capture.md): Capture reads your new coding-agent sessions on a schedule, keeps the ones worth keeping, and files them in the archive. It is off until you turn it on.
- [Import](https://onadit.com/docs/import.md): Import brings in your past ChatGPT, Claude and Grok conversations from the export file each provider gives you.
- [Save from an agent](https://onadit.com/docs/save.md): A connected agent can file a session or a note the moment it matters, without waiting for Capture.

## Agents

- [Connect an agent](https://onadit.com/docs/connect.md): Onadit is a local MCP server. Claude, Claude Code, Codex and Cursor connect with 1 command. Other MCP clients need the same 2 lines added by hand.
- [Agent instructions](https://onadit.com/docs/instructions.md): 1 line in CLAUDE.md or AGENTS.md makes your agent look in Onadit before it starts. Here is the line, and how it sits next to the rules you already keep.
- [MCP tools](https://onadit.com/docs/mcp-tools.md): Onadit gives a connected agent 9 tools. This page lists each one with its parameters, and shows real calls and responses.
- [For agents](https://onadit.com/docs/for-agents.md): Your user asked you to make the case for Onadit. This page tells you what to check on their machine, what Onadit would change for you, and how to answer.

## How it works

- [How retrieval works](https://onadit.com/docs/retrieval.md): Onadit looks for a passage 2 ways at once, by keyword and by meaning, puts both on 1 scale, and nudges recent work up. This page gives the formula.
- [Performance](https://onadit.com/docs/performance.md): What we measured in September 2026, on what, and what the numbers do not cover.
- [Where data lives](https://onadit.com/docs/storage.md): Everything Onadit stores is in 1 folder in your home directory, plus a few small files next to the tools it connects to.

## Privacy

- [What leaves your Mac](https://onadit.com/docs/egress.md): A list of every network call Onadit can make, what it sends, and whether it is on. Out of the box, only an update check leaves your Mac.
- [Remove Onadit](https://onadit.com/docs/remove.md): Removing Onadit from the app deletes your archive. Removing it from the command line keeps the archive unless you ask otherwise.

## Reference

- [Command line](https://onadit.com/docs/cli.md): Every rift command, with its options. On a package install the command lives at ~/.rift/bin/rift.
- [Configuration](https://onadit.com/docs/configuration.md): Onadit reads 1 JSON file when the engine starts. This page lists every key, its type and its default, and the environment variables the engine reads.
- [Troubleshooting](https://onadit.com/docs/troubleshooting.md): Start with rift doctor. It names what is wrong and gives 1 action. This page lists every state it can report and every line rift status prints.
- [Limits](https://onadit.com/docs/limits.md): What Onadit does not do today, stated plainly.