MCPOpen source · MIT · zero dependencies

Give your agenta memoryit keeps.

Nexorum keeps what your agent learns as plain files on your machine: short notes, session transcripts and a small linked wiki. A background dream reviews them, corrects stale facts and proposes better memory. You read the diff and approve it.

$ npx nexorum init
CAPosted here at launch

Free and open source. No account. Nothing leaves your machine until you dream.

Works with
  • Claude Code
  • Codex
  • Cursor
  • Hermes
  • Claude Desktop
  • Any MCP client
Features

What your agent gets

17 MCP tools and a context resource. Notes are searchable right away; dreams turn them into a wiki you review.

Notes

Short memories the agent saves itself.

remember update_note forget list_notes

Recall

BM25 search over notes and wiki pages.

recall search_documents

Context

A short digest of the wiki, loaded at session start.

context nexorum://context

Wiki

Plain markdown pages, linked from an index.

read_document list_documents related_documents document_history

Sessions

Transcripts for later dreams, and the state of memory.

save_transcript memory_status

Dreams

Review proposals, or dream through your agent with no key.

list_proposals show_proposal dream_prepare dream_submit

Pricing

Free, and your data stays yours.

Nexorum is open source software that runs on your machine. There is nothing to sign up for. Notes, transcripts, the wiki and its history are files under ~/.nexorum; delete the folder and the memory is gone.

The only thing that costs money is the model you choose to dream with, and you pay that provider directly. A dream sends transcripts, notes and wiki pages to the LLM you configure, and nowhere else.

The CLI and MCP serverMIT licence, runs on your machineFree
Dreamingyour key, your budgetYour provider
Accounts, servers, telemetrythere are noneNone
Drag to spin The $NEXR coin
0Accounts or servers
4Memory layers
17MCP tools
18CLI commands
Workflow

How it works

Your agent writes notes and its sessions are saved as transcripts. A dream looks back over them with hindsight and proposes updates to a small wiki. The next session starts from the approved version.

01

Your agent works

Claude Code hooks or the MCP server save short notes and session transcripts to ~/.nexorum. Known secret patterns are redacted before anything is written.

02

Memory is searchable

Notes and wiki pages are ranked with BM25 keyword search, and the agent can follow links between pages from the index. No embeddings, no vector database.

03

A dream corrects it

nexorum dream checks the wiki against your transcripts, fixes stale or wrong facts, merges duplicates and links pages. It writes a proposal; nothing changes until you apply it.

04

The next session knows

A short index of the wiki is loaded at session start, so your agent does not have to rediscover what earlier sessions already learned.

~/projects/orbit-apiexample session
$ nexorum remember "Run tests with pnpm test:unit, not npm test"
Saved note note_7Qm2xK9vTq.
$ nexorum dream
Pending transcripts: 3
Unconsolidated notes: 4
Rough estimate: ~180,000 tokens (budget 3,000,000). This is billed by your LLM provider.
Proceed? [y/N] y
Proposal prop_8f2c41 (review): 2 added, 2 modified, 0 removed
  added    /ci.md
  added    /config.md
  modified /testing.md
  modified /_index.md
$ nexorum diff
~ /testing.md
- Tests: `npm test` (jest)
+ Tests: `pnpm test:unit` (vitest), since 2026-11-19
$ nexorum apply
Applied: 4 path(s) written.
Notes are searchable right away. The wiki only changes when you run nexorum apply.
Safety

Memory that gets reviewed, not just stored

Notes are searchable right away. Dreams turn notes and transcripts into a small wiki and propose fixes. You decide what is applied, and everything stays in files you own.

A wiki your agent can navigate

Plain markdown files in ~/.nexorum, linked to each other, with an _index.md that lists them. Open them in any editor, or let the agent follow the links.

Every change is a version

Each write to the live wiki, from a dream you applied or from you, is recorded. See the history of a page and restore an earlier version.

0 changes without you

A dream only writes a proposal. Nothing reaches the live wiki until you run nexorum apply, and a page changed since the dream started is skipped.

Dream with a key, or without one

Use your own key (Anthropic by default, or any OpenAI-compatible endpoint), or let the agent you already run dream through two MCP tools. Key runs are estimated first and stop at your budget.

Secrets are scrubbed

API keys, tokens and private keys are replaced with [REDACTED] markers in transcripts, notes and anything a dream writes, before they reach disk.

Review, diff, apply or reject

Read the line diff against your live wiki, then apply or reject it. The agent can read proposals but never apply them.

FAQ

Questions, answered

More in the docs, or ask us on X.

What does a dream change?
Nothing, until you apply it. A dream writes a proposal: line diffs of every page it wants to add, change or delete. A page that changed since the dream started is skipped, not overwritten.
Do I need an API key?
No. Use your own key (Anthropic by default, or any OpenAI-compatible endpoint, including a local router), or let the agent you already run do it through two MCP tools. Key runs are estimated first and stop at the token budget you set.
Where is my memory kept?
In ~/.nexorum, one space per project, as plain files. Open them in any editor, commit them to git, or delete the folder.
Are secrets safe?
Known patterns such as API keys and tokens are replaced with [REDACTED] markers in transcripts, notes and anything a dream writes, before they reach disk. This catches known patterns, not everything.
What is $NEXR?
The community token for Nexorum. You never need it to use the software.
Get started

Start in one command.

Or watch it work first: the simulation takes about a minute and runs in your browser.

  • Free and open source, MIT
  • No account, no server, no telemetry
  • Plain files on your machine
$ npx nexorum init
Posted here at launch
Works with
Claude CodeCodexHermesCursorClaude DesktopAny MCP client
Read the docs

Local: notes, transcripts, wiki and history are files under ~/.nexorum. Dreaming sends them to the LLM you configure, and nowhere else.

Deliverables

    Open the docs