1. Download free
Request your free access with an email address, then run OneMemory-Setup.exe. It installs for your Windows user and starts the tray app. No admin prompt appears.
Start in five minutes.
Create free access. Install OneMemory. Connect your AIs. Save one memory and recall it from another tool.
2. Choose what OneMemory can capture
The first-run setup asks plainly before enabling session observation. Capture is off until you turn it on. You can change the choice later from the tray app.
- Choose the desktop data folder.
- Turn observation on or leave it off.
- Select the AI tools you want to connect.
- Enable cloud sync if it is available for your beta account.
3. Connect your AI tools
Claude Code
Start a new session and ask, "What do you remember about me?" Claude Code should call the onememory MCP tools. You can also inspect /mcp for the server entry.
Claude Desktop
Restart Claude Desktop after setup. The tools menu should list onememory.
Codex
Start a new session. Codex reads the OneMemory MCP entry from its configuration automatically after the installer wires it.
Other MCP clients
Add onememory as an MCP server in the client settings, then restart the client.
4. Save your first memory
Tell a connected AI: "Remember that staging deploys run from the release branch."
OneMemory turns the statement into a source-backed claim, redacts any secret material, applies policy, and activates the memory if it passes. No approval chore is required.
5. Recall it somewhere else
Open another connected AI and ask how staging deploys work. It should recall the memory, its scope, and its evidence.
Open the dashboard to see the memory in the constellation. Inspect which AI wrote it, which computer observed it, when it arrived, and what source supports it.
6. Check sync
If cloud sync is enabled for your account, open OneMemory on another computer and check the sync status. Portable memory should appear with its origin computer intact. Host-local facts should remain identified as computer-specific.
Desktop working files
%LOCALAPPDATA%\OneMemory\ onememory.sqlite3 desktop working memory config.env local settings and client key logs\ service, observer, and tray logs backups\ desktop backups
The desktop working store supports fast and offline recall. Cloud sync is a separate lane and follows the sync policy shown in the app.
Troubleshooting
The tray says offline.
Quit OneMemory from the tray, then start it again from the Start menu. Check logs\server.err.log if it stays offline.
An AI cannot see the tools.
Restart that AI client. MCP servers load when the client starts. Run the connection step again from OneMemory settings if needed.
Port 8787 is busy.
Set ONEMEMORY_PORT in config.env, restart OneMemory, then reconnect the clients.
Cloud sync is not available.
Hosted consumer sync is rolling out through the beta. Confirm that the account is enabled and the computer is online. Desktop recall continues while sync is unavailable.
I want all my data.
Use Export in the dashboard. Full export is included.
Need help?
Email hello@onememoryai.com. Include the relevant log files for a crash. Review them before sending and remove anything you do not want to share.