Documentation

Everything written down about Mind Archive. The documentation is part of the product rather than an afterthought, so it is kept accurate: if behaviour changes, the page describing it changes in the same commit.

Start here

• Product What Mind Archive is, who it is for, and what it deliberately is not.
• Development Running it, testing it, and working on it — Docker and native, with WSL2, Windows and macOS notes.
• Git and SSH setup Keys, the agent and the remote, from WSL2 — including the network where port 22 does not work.
• Try it yourself The shortest path from a clone to your own conversations, searchable.
• Getting your conversations sooner An official export can take days. An optional script you run in your own browser is faster.

How it works

• Architecture How the pieces fit: importer adapters, the archive, search, and why SQLite is only an index.
• Security and privacy The threat model stated plainly — including what Mind Archive does not protect you from.
• Decisions Every architectural decision, dated, with the reasoning that produced it.

Where it is going

• Coming next What works today, what is being built, and what has been deferred on purpose.
• Roadmap The milestone plan.
• Backlog Ideas and known gaps. Nothing here is a commitment.

Running the project

• Contribute What is useful right now, and what has to wait for a Contributor Licence Agreement.
• Support Donate to keep the importers working, and where a licensing question goes.
• Deployment How the site is published, and why the application is not hosted anywhere.
• The documentation site How this site is built, and how to preview it before you change it.

Reference

The repository's own canonical documents, published here verbatim. Each one is generated from the file itself, so what you read is what the project actually works from — there is no second copy to fall out of date.

• Licensing The position in plain language: proprietary, all rights reserved.
• The licence The copyright notice, in full.
• Contributing The full contribution guide, including what a pull request is checked against.
• Code of Conduct What is expected of anyone taking part.
• Configuration reference Every setting, annotated, with its default. Nothing here enables cloud anything.

The working record

Notes written for the people and agents building this, not for a reader — plainer and more provisional than the pages above.

• Decision log Every decision in full, numbered and dated, including the ones that were reversed.
• Milestones The authoritative scope: what is finished, what is in progress, what is out.
• Research Findings that settled an argument once — measured timings, format details, version floors.
• AGENTS.md The canonical instruction file for anyone working on Mind Archive, human or AI.
• AI agent protocol How an AI agent is expected to work in this repository.
• Session protocol How each working session is recorded, so no decision survives only in a chat log.

Every page here is written as a Markdown file and rendered for the site, so what you are reading is the document itself rather than a copy of it. Mind Archive is proprietary and its repository is private, so the files are not browsable — the pages above are the published form.