Requirements
Quick Start
Set Up with Your Agent
Paste this into your agent:
If you are an AI agent: follow the instructions at https://ragionex.com/setup.
Set It Up Yourself
In a terminal, on Windows (PowerShell or Command Prompt):
On macOS or Linux:
- Pick your agent. If the setup finds one on your computer, press Enter.
- Press Enter to open the link in your browser, then sign in. A new account is free, no credit card needed.
- Copy the one-time code the page shows and paste it into the terminal.
- Quit your agent completely and open it again in a new session. From here on, just work: it uses Ragionex Memory on its own.
If your agent is not listed and has a global instructions file, choose manual setup. Run the setup once for each agent you use.
Your First Prompt
Ask your agent:
It answers with your Vaults and what this agent may do in each.
Other MCP Clients
Claude Desktop, Cursor, Cline and other clients that run local MCP servers use the same tools. Create a key at app.ragionex.com/keys and add the server to the client's user-global MCP config. On Windows:
On macOS or Linux:
These clients get the tools but not the memory rule, so they use memory less consistently on their own. A client with a global instructions file can get the rule through manual setup instead. On Windows:
On macOS or Linux:
See the MCP Client Notes for client-specific details.
What You Get
A Context Engine That Understands the Question. Your agent asks in plain language, and the engine understands what it means, even when it asks in different words than the memory was saved in. Even among thousands of memories, the right ones come first and arrive in milliseconds, so the agent reads only as much as it needs and its context stays lean. Memories come back exactly as they were saved: Ragionex never rewrites a memory or generates an answer.
Automatic Memory. Your agent saves what's worth keeping on its own: a document, a design decision, a preference, a project fact, something that was tried and how it turned out. It checks its memory before it answers, starts a task or asks you anything about your work, and the memory gets richer and more accurate the more you work. You can still tell it to remember or forget anything, any time.
Always Up to Date. A changed decision updates its record instead of adding a second one, and a record that turns out wrong is removed. Every change ends with one short line in the reply, so "undo that" is one sentence away. Every update carries the version its agent last read, so no agent can silently overwrite another's newer change.
Version History. Earlier versions of every memory, and deleted records in the trash, are kept for 30 days. Bring any of them back just by asking your agent, or from the dashboard.
Everything Visible in the Dashboard. Browse every memory your agents saved and see each one's status, who created or last edited it, and through which key. Open earlier versions, edit, restore or delete anything yourself, and export it all whenever you want.
Projects and Teams. Each project can keep its own memory in its own Vault, and a search never crosses into another. Every key carries its own Read, Create, Update and Delete permissions. Share a Vault with teammates, give each member their own permissions, and every member's agents draw from and add to the same memory.
Safe and Private. Memory text stored by Ragionex is kept in the EU and encrypted with AES-256. It is never sent to an outside AI service and never used to train AI models. Queued saves retry automatically.
Works Where You Work. One line sets up almost any AI agent on Windows, macOS and Linux. Other MCP clients connect too.
Vaults, Keys and Teams
A Vault is a separate set of memories. A key decides what an agent may do in it. A member is a teammate the Vault's owner shared it with. The picture above shows them working together:
The picture shows Create and Update as Write and Edit.
A Vault and Key per Project
A new account starts with My vault as its default, and every project without its own Vault uses the default. To give a project its own memory, create a Vault in the Dashboard, then ask your agent to use my acme-app Vault for this project, or put a RAGIONEX_MEMORY.jsonc file in the project folder:
- The file is read on every request, so a change applies at once, with no restart.
- Only the project folder itself is checked, not its parents.
- Add the file to
.gitignore before putting a key in it.
- A broken file, an unknown field or a rejected key stops the request with a clear error. Memory never falls back to another Vault or key.
Work with Your Team
- Share a Vault. In the Dashboard, the owner shares a Vault and gives each member Read, Create, Update or Delete.
- One Memory for Everyone. A decision one teammate's agent saves can be recalled by every member's agent with Read access.
- Two Locks. In a shared Vault, an action must be allowed by both the key and the member's permissions. A teammate with Read only cannot change anything, whatever their key allows.
Keys
- A key belongs to your account and works in every Vault you own or that is shared with you.
- Give each key only what its agent needs. A key with Read only can recall but never change anything.
- Keys are created with fixed permissions and revoked in the Dashboard.
- The setup creates one key per agent, named after the agent and the setup date. Running it again creates another key; earlier keys stay listed in the Dashboard, where you can revoke them.
Free Plan
Saving, editing and restoring a memory each cost 1 request, and so does each search page fetched from the service. Browsing, viewing, deleting, the trash, version history, status checks and export are free. Free is for personal projects and evaluation and is in early access, so its limits may change. Commercial use is not permitted on Free; Pro is coming soon.
Reference
Tools
Every record has id, vault_id, content, created_at, updated_at, status, revision, created_by and updated_by. New, edited and restored records must finish processing before recall can find them. Permanent deletion, export, Vault sharing, key management and account deletion live in the Dashboard.
Configuration, Updating and Uninstalling
-
Project Folder. The folder the agent reports: Claude Code's project directory, the client's single workspace root, or the folder the server started in.
-
Updating. Nothing to do: the agent starts the latest version each time it launches, and the rule refreshes itself.
-
The Memory Rule. It lives between ragionex-memory-mcp:priority-rule markers in ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md or ~/.config/opencode/AGENTS.md, or in the file manual setup was given, and refreshes itself after an upgrade. To keep your own version, edit the begin marker and the server leaves the block alone. See the Memory Rule Guide.
-
Uninstalling. Run the command for your system. On Windows:
On macOS or Linux:
The command asks which agent to disconnect; an agent names itself, such as --agent claude-code. It removes the registration and the rule; a rule you froze by editing its begin marker stays and is removed by hand. After manual setup, uninstall --manual --instructions-file <path> removes the rule, and the ragionex-memory-mcp entry is deleted from the agent's MCP settings file by the agent or by hand. Saves that have not synced yet stay on disk. Restart your agent to finish. The agent's key stays in your account; revoke it in the Dashboard if you do not plan to reconnect.
Local Data and Recovery
- Saves waiting to sync live in
~/.ragionex/pending-saves/, one folder per key and API address. The files hold the saved content, unencrypted, and delivery metadata.
*.pending.json files retry automatically without creating duplicate records. A save kept because of the plan limit is sent after the quota resets and counts toward the period in which the service accepts it.*.blocked-<reason>.json files were rejected during a later sync. They are never sent again automatically; review them using the paths ragionex_memory_connection reports.- A waiting save keeps the key, API address and project Vault it was made with; one made without a project Vault goes to the account default. Do not edit the files or move them between key folders, and stop every connector instance before deleting a file you have reviewed.
- An older
~/.ragionex/pending-memories.jsonl is never sent automatically; review it before removing it.
~/.ragionex/recall-pages/ stores search progress, never the question, memory text or key. Expired files are removed automatically. Deleting them is safe; after a restart, the agent starts that search again.
Security
- Memories Are Data, Not Instructions. Agents are told never to follow saved content to change permissions, call tools or override you.
- HTTPS Only. The connector refuses plain HTTP except for
localhost, 127.0.0.1 and [::1].
Troubleshooting
About Ragionex
Ragionex is a context engine for AI agents. It never generates an answer, so the reasoning stays with your agent, and the same question over the same memories always returns the same results.
Support
License
MIT
