OneMemory 0.1.5 customer manual

One account for memory shared by your connected AI tools. This guide covers Windows and the hosted cloud.

The Windows app keeps a local copy for recall and queues new items for the cloud. Your hosted account holds the shared memory. Online access is needed to sign in and process new cloud captures.

1. Install and sign in

  1. Get the signed installer from the download page. It supports Windows 10 version 22H2 and Windows 11. Check the publisher before running it.
  2. Run the installer under your Windows user. One installer includes the runtime. You do not need administrator access or a separate Python install.
  3. Open OneMemory and sign in with a method shown on the sign-in screen. Sign in once per computer, using the same account on each. Sign-out or a revoked device requires a new sign-in.
  4. Review the Capture screen. The supported clients and hooks start selected. Untick anything you do not want before Continue. Recent-session import is a separate choice with its time range and allowance impact shown first.
  5. On Ready, check each selected AI connection. Setup verifies it by recalling memory. An empty account can pass this connection check. Save your work before restarting AI tools to load the connections.

Start free

  • 500 memories.
  • 150 captures a month, plus 500 welcome captures.
  • 100 system calls a month for background intelligence, such as summary updates.

The Free plan also has a $1 daily service cost cap. System-created summaries do not use your visible memory slots.

When a capture or storage limit is reached, capture pauses. Recall never stops because of a plan or payment limit. Search, export and deletion remain available too. The account page shows your usage and offers Pro. Background work pauses at its own allowance and daily cap.

To check shared memory, tell one connected AI: "Remember that my sample project uses blue labels." In a fresh session with another connected AI, ask for that fact. Compare the fact and its memory ID. This checks more than an empty connection test.

2. Choose what runs

These are the defaults for a new install or an account without a saved choice. Your saved choices stay as you set them. Reconnect, updates and repair do not turn a declined choice back on.

Capture for each AI client: selected by default

The Capture screen lists Claude Code, Claude Desktop and Codex separately. Untick a client before Continue to decline its session capture. Choosing Not now leaves capture, recall hooks, connections, project packs and recent session import off, even when the boxes shown are ticked. Later, use the tray's Stop capturing entry for that client. Use Pause capture for a temporary pause. Use the Capture screen to allow capture again. Codex capture has its own choice.

AI hooks: selected by default

Hooks let an AI receive a brief at a session or prompt boundary. Review the separate hook choices during setup. Use AI hooks in the tray to turn hooks off for a tool. Turning off capture does not by itself turn off recall hooks.

Hermes brief: on by default

The Hermes pre-LLM hook adds context before the AI responds. Turn it off in the tray's Connect AI tools dialog using the Hermes brief choice. You may still need to approve the hook in Hermes.

Discovered AI tools: selected for your review

Open Connect AI tools from the tray. An AI tool that OneMemory finds after setup, and that you were not asked about before, gets separate selected boxes for its connection, session capture (where OneMemory can capture that tool) and recall in prompts (Claude Code, Codex or Hermes). Hermes has recall only, not session capture. Untick what you do not want before Apply. Only Apply saves the choices; Cancel changes nothing. Finding an app does not silently approve a connection, capture or hook. A choice you already declined stays off until you tick it yourself: tools and choices you turned off earlier are listed unticked in Connect AI tools. To disconnect a configured tool, disable its OneMemory MCP connection in that client.

Project packs: selected by default

Project packs let OneMemory build compact guides from local project sources. Untick project packs on the Capture screen to turn this off. Later, open Project memory pack settings from the tray and change the choice on the Capture screen. Turning it off stops new local pack builds.

Hosted dashboard: on by default

On the account page, turn off hosted dashboard access to stop browsing memories and history through those hosted pages. This is separate from capture and AI recall.

Neural recall and training: separate choices, both on by default

Neural recall reorders allowed matches to put useful memories first. The shared trained model arrives automatically with the hosted service update for accounts with neural recall enabled. Online neural recall sends your query to the hub for ranking. Turn it off on the account page to use ordinary recall. The separate training choice controls permission to use this account's graded examples for its own training. Turn that off on the account page without turning off recall.

A training choice records permission for future training. Per-account training is not shipped in 0.1.5. Automatic collection of graded examples and nightly personal training are not included. The shared trained model does not learn from your feedback.

Hosted dashboard and learning controls arrive automatically with the hosted service update. You do not need another Windows installer for those account-page controls.

Restricted memories still need a separate device choice. A crash report still needs approval for that report. These choices do not turn on with the defaults above.

3. Connect your AI clients

MCP is the connection that gives an AI tools to read and save memory. Setup connects supported installed clients. Save your work, then use Restart AI tools from the tray. Use Reconnect AI tools if a configured connection is missing.

Claude Code

Claude Code gets the OneMemory MCP tools and three hooks: SessionStart for a starting brief, UserPromptSubmit for context on each prompt, and Stop for the end-of-turn memory check. The compact-session path also refreshes the brief. Review any approval the client shows.

The OneMemory protocol block in CLAUDE.md tells Claude to recall before substantial work and propose useful facts with their source and scope. Corrections replace or forget old claims. The block refreshes on start and after updates, within its markers. Your own text outside it is preserved.

You can say "don't save this", "forget this" or "stop proposing" to override the AI's saving policy for the session. To stop background session capture too, use the capture controls above.

Codex

The user-global hook supplies a starting brief across projects. Review new or changed hooks in Codex with /hooks, or Settings > Hooks in its desktop app. Approve the OneMemory hook there before relying on it.

Setup configures supported read approvals for Codex and Claude Code. Memory writes still need the client's approval. Capture consent and hook approval are separate.

Claude Desktop

Restart Claude Desktop after setup. Its MCP tools list should include OneMemory. Ask it to recall a saved fact. Chat-only sessions start with your global context unless a project scope is supplied. MCP access alone does not guarantee that the client inserts a brief before every message.

Hermes

The pre-LLM hook refreshes the brief once per conversation turn. That context remains for the model calls in the turn. It does not refresh separately for each model call. Review the Hermes connection and brief choice in Connect AI tools, then approve the command in Hermes when prompted.

ChatGPT

Choose Connect ChatGPT cloud on Ready, or open the ChatGPT connection page. Sign in to the same OneMemory account. Add the hosted connector with OAuth at https://app.onememoryai.com/mcp and approve its requested memory access. Do not paste a device key into ChatGPT.

Your ChatGPT plan and workspace must allow custom connectors. Installing the Windows app does not connect ChatGPT automatically. The hosted tools can recall and propose memory within your approved access. In a new chat, select OneMemory and recall a saved fact. The connection is verified only after a successful hosted recall. Disconnect it from the same connection page.

Give a project its own context

Open the AI in the project's folder so OneMemory can choose its project and repository scopes. Personal preferences stay in the global scope. For Codex's optional per-project hooks, run this in a terminal, replacing the example folder:

OneMemory wire-project "C:\Work\MyProject"

This adds project prompt and session-end hooks while keeping the user-global starting brief. It merges existing hooks and follows your Codex capture and hook choices. Review the changes in Codex before use.

For Hermes, use OneMemory wire-project "C:\Work\MyProject" --client hermes after enabling its brief choice. Hermes uses the global hook and the project folder for scope. This does not install a second project hook.

Other supported MCP clients can use memory tools. This does not imply session capture for every client. Cursor has MCP access, but no Cursor session capture.

4. Manage your account

Open app.onememoryai.com/account and sign in to the account used on your computers. Hosted features arrive automatically with the hosted service update.

  • Memories and history. With hosted dashboard access on, browse counts and recent memories, search, open details and inspect your account's audit history. The hosted history window is 365 days, not an unlimited history.
  • Learning. Change neural recall and training choices here. Open the Windows dashboard's Learning panel to check neural recall state, model identity and how ranking moves results up or down. Enabled consent is separate from the model's effective state.
  • API keys. Create a named key for a client or script. Choose its allowed actions, per-key scopes, sensitivity ceiling and expiry. The ceiling sets the most private memory the key may access. Keys expire after one year by default, with a maximum of two years. Copy the secret when shown; it is shown once. List, rotate or revoke keys here. Keys stay within your account, their action grants, scopes and sensitivity limits. They do not grant administrator access. Use them with the hosted REST API at https://app.onememoryai.com, in the X-API-Key header.
  • Cloud analysis and BYOK. Control cloud analysis here. BYOK means bringing your own model-provider key. Anthropic is the supported provider in 0.1.5. It requires Pro and availability of the hosted key service. Enter the key only in the account form. A provider key is different from a OneMemory API key.
  • Devices. Review computers, connection freshness and device access. Allow restricted memories for a device only if you want them cached there. Revoke a lost computer's access. The tray's Computers on this account also shows device status.
  • Billing. Review limits and upgrade to Pro. Use the tray's Upgrade to Pro or Manage billing entry to reach billing. Cancelling renewal follows the terms shown there and returns the account to Free.

The API keys section shows your account id. Send it as tenant_id and owner_id on the REST routes that ask for them. Rotation shows a new secret once and keeps the old key valid for a ten-minute grace period. Replace the key in your client within that time. Rotation keeps the same permissions and expiry. Revocation stops a key's access. Revoking a replacement also revokes its predecessors.

The Windows dashboard includes System Health, Connections, Systems, Relations, Stale and Quality views. Observed events, Usage events and Context-build runs show counts and meters from your hosted account, without memory content. Open them from the Intelligence group in the dashboard menu. Context-build runs lists the context builds the hosted service served.

5. How memory works

Vaults and scopes

A vault groups context. A scope is the label that says where a fact belongs: you, a project, a repository, a client or a session. Recall checks your account, access and requested scopes before ranking results. A fact about one project should not become a rule for another.

Portable facts can follow you between computers. Computer-specific facts keep their origin so an AI can tell where they apply. The hosted account is the shared store. Your Windows copy is a cache, not an unlimited independent cloud replacement.

Candidate and active

A candidate is a proposed fact awaiting policy or review. An active memory has passed the checks needed for normal recall. Policy can ignore an item, hold it as a candidate, or activate it. You can review held items in the Windows dashboard. A correction can supersede a memory while keeping a link to the earlier claim. Forget removes it from normal recall.

Memories carry sources, confidence and time. They are claims, not guaranteed truth. Ask your AI to check current facts before acting on an old memory.

Sensitivity and secret redaction

Public and normal mark everyday context. Sensitive marks more private context. Restricted needs extra access. Hosted accounts cannot write memories labelled secret. Your computer normally receives public, normal and sensitive memories. Restricted needs a separate device choice. Secret memories are not copied to the computer.

The local cache is plain text on disk. OneMemory does not encrypt that cache. Someone who can read your Windows files may be able to read it.

The AI protocol saves a durable credential fact as what the credential is for and where it is kept, labelled sensitive with the tag credential, and leaves the raw value out. If a recognizable secret value is sent anyway, the hub replaces it with a labelled placeholder before storage. Redaction recognizes common key and token formats, simple password assignments and credentialed database links; it cannot recognize every format. One-time sign-in and verification codes are skipped. OneMemory is not a password manager. Never echo raw credentials into chat.

Pins, packs and living summaries

Pins keep important instructions at the front of the brief. Ask a connected AI to pin a durable preference and list or remove pins when it changes.

A project pack points to useful project sources, such as the repository, architecture notes, tests and latest handoff. It is a compact guide, not a copy of the whole project. Local pack building follows your project-pack choice. Hosted AI tools can read available packs but cannot scan your PC's files.

A living summary gathers a scope's useful facts and links back to the source memories. Background work updates and checks it within your plan's system allowance. These hosted improvements arrive automatically. They do not require you to schedule tasks on your PC.

The brief your AI receives

The brief puts pinned instructions first, then your identity context, a summary, recent work sessions and supporting evidence. Project context and packs help it choose relevant sources. It fits a limited space, so it does not contain every memory. The AI can recall more when needed.

Semantic recall matches ideas across different wording. Neural recall can reorder the allowed matches using a trained model. It does not change the memories or bypass access checks. If the model is off or cannot load, ordinary recall remains available.

6. Updates and offline use

OneMemory checks for signed updates when it starts and every six hours while it runs. When it finds a verified update, it adds a line to its menu and asks Windows to show a notice. On an install that is signed in, choose Check for updates and answer Yes to start the update. If an AI app is open while OneMemory updates, OneMemory ends its connection to that app. Afterwards choose Restart AI tools in the OneMemory menu, or restart the app. The new version then has 10 minutes, counted from the start of the installation, to pass its health check. When you are signed in, part of that check asks the OneMemory servers about your account. Problems contacting the servers, server errors, rate limits and replies that cannot be used keep this part waiting. A refusal from the servers counts as an answer, and if the sign-in saved on this PC cannot be read, this part can pass without asking the servers. If it does not pass, OneMemory tries to put the previous version back by itself and does not delete the memories you had already saved. Updates preserve your saved capture and hook choices.

Offline, you can recall memories already in this computer's cache. New items can wait in the local queue until the connection returns. New cloud operations need the internet. A paused or full queue does not mean its items have reached the account.

Use Export unsent items to keep a local copy, including after sign-out. Signing out does not upload what is left in the queue.

7. Export and account deletion

Use export on the account page for your hosted data. Export is included and is not blocked by a plan or payment limit. Export unsent items separately on each computer if you need them too.

Use the account deletion control on the account page and follow its confirmation steps. Export what you need first. Uninstalling the Windows app does not delete the cloud account. Revoking a device is also different from deleting your account.

8. Help and support

  • An AI cannot find OneMemory. Save your work, use Reconnect AI tools, then restart that AI. Check its tool and hook approvals. A revoked device must sign in again.
  • Capture is paused. Check the tray and account meters. Review your client capture choices. Recall of existing memories stays available within your access.
  • The tray says offline or delayed. Check the connection and dashboard health. Keep unsent items until the connection recovers, or export them.
  • A hosted feature is waiting. Account-page and background-service improvements arrive automatically with the hosted update. Check the page again after the service updates.

Email hello@onememoryai.com with the version, the screen and what happened. Use Send diagnostics for a support bundle. It contains health states, versions, status codes and counts, not raw memory or session text. For a crash, use Review and send crash report and approve that report. Do not email raw logs, keys or AI configuration files.