git:20261005.ec9d23c to git:20261005.71feee3

# Wordcell

> Wordcell keeps decisions, plans, and sources as Markdown beside your code,

> so coding agents can find them from the file they are about to change.

A new coding-agent session can read your code, but not the decisions that

stayed in the last session's chat. Wordcell keeps those decisions as Markdown

files beside the repository, with the plans that depend on them and the web

pages and PDFs that informed them. Tie a note to the paths it explains, and an

agent about to change that code runs one command to get the notes and plans

for that path. Exact search, backlinks, and Git history run on your machine

with no account or model, and every index rebuilds from files you can read in

any editor. Wordcell is free and open source.

When to use this site:

- Use wordcell.io to learn what Wordcell does, what stays on your machine, and

the current install command.

- Use /developers for the coding-agent workflow: context for a repository path,

AGENTS.md rules, Git history, and the Agent Skill.

- Use /docs for the documentation: a tutorial, how-to guides, the command

reference, and design explanations.

- Use /blog for longer posts on why Wordcell works the way it does.

## Pages

- [Wordcell](https://wordcell.io/): Quick start, connecting a local agent, how

notes, links, and search work, how Wordcell uses Oh, comparisons, publishing selected

notes, what stays local, and the install command.

- [For developers](https://wordcell.io/developers): The coding-agent workflow:

code-path context, scoped rules, note history, and the Agent Skill.

- [Benchmarks](https://wordcell.io/benchmarks): Wordcell exact search and optional

reranking on 300 SciFact queries, with methods and raw results; separate

sourced memory-retrieval studies from Oh and other systems.

- [Wordcell vs Basic Memory: two Markdown knowledge graphs](https://wordcell.io/compare/basic-memory):

Where notes live, how notes form, note structure, search, repository

context, and cost, with Basic Memory's documentation checked on

September 26, 2026.

- [Wordcell vs Mem0: agent notes or per-user app memory](https://wordcell.io/compare/mem0): Where memory

lives, how memories form, whose memory it is, the Platform and open-source

split, and cost, with Mem0's documentation checked on September 26, 2026.

- [Wordcell vs Obsidian](https://wordcell.io/compare/obsidian): Coding-agent

context and typed relationships alongside Obsidian’s editor, CLI, and Publish.

- [Wordcell vs Supermemory: files or a hosted memory API](https://wordcell.io/compare/supermemory):

Where memory lives, how memories form, cost with Supermemory's pricing

checked on September 26, 2026, connectors, compliance, agent access, and

when to choose each.

- [Wordcell vs Claude-Mem: notes in Git or captured sessions](https://wordcell.io/compare/claude-mem):

How memory forms, what loads at session start, where it is stored, what a

fresh clone gets, and model use, with Claude-Mem 13.30.0 and its

documentation checked on October 4, 2026.

- [Migrate from Supermemory to Wordcell](https://wordcell.io/migrate/supermemory):

The install, export, import, and verify steps from the migration guide, with

a prompt that connects a local agent.

- [Documentation](https://wordcell.io/docs): The documentation index, grouped

into tutorials, how-to guides, reference, and explanation, with the install

command.

- [Get started](https://wordcell.io/docs/getting-started): The first-vault

tutorial.

- [Overview](https://wordcell.io/docs/overview): What Wordcell does, how to

install it, and how a coding agent uses a vault, on one page.

- [Use Wordcell with a coding agent](https://wordcell.io/docs/agent-workflow):

Set up, query, maintain, and revise repository memory.

- [Connect Wordcell to your coding agent](https://wordcell.io/docs/agent-handoffs):

Register the local MCP server with Claude Code, Codex, Cursor, or Claude

Desktop, check that the agent reads your notes, and fix common errors.

- [Use Wordcell with an existing Obsidian vault](https://wordcell.io/docs/obsidian):

Which Obsidian links, tags, and attachments Wordcell reads, and how to serve

a vault to a coding agent without changing it.

- [Reference](https://wordcell.io/docs/reference): Exact commands, formats,

SDK imports, optional adapters, and the local MCP server (wordcell mcp)

with its flags and tools.

- [Publish](https://wordcell.io/docs/publish): Select notes and build a static

site.

- [Migrate from Supermemory](https://wordcell.io/docs/migration-from-supermemory):

Export Supermemory documents and memory entries, import them as Markdown

notes, and see what does not transfer.

- [Sync a vault with Git](https://wordcell.io/docs/sync): Keep one vault

current on several machines with a private repository and a scheduled

commit and push.

- [Comparisons](https://wordcell.io/docs/comparisons): Markdown tools such as

QMD, Basic Memory, and Obsidian, Claude Code's built-in memory and

claude-mem, and agent memory services such as Supermemory, Mem0, and Zep,

compared with Wordcell from primary sources.

- [Evidence](https://wordcell.io/docs/evidence): The reproducible

development fixtures used to check passage selection and context size, with

their raw reports; source-ranking benchmarks are on /benchmarks.

- [Markdown-memory retrieval pilot](https://wordcell.io/docs/markdown-memory-pilot): Historical measurements and methods on a frozen repository corpus.

## Blog

- [Wordcell blog](https://wordcell.io/blog): Posts on how Wordcell keeps

Markdown as the record and how it works with other Hraness tools. Atom feed:

https://wordcell.io/blog/feed.xml

- [Free local agent memory in Markdown files you own](https://wordcell.io/blog/free-local-agent-memory):

What the launch adds, the measured results with their limits, and how to

move from Supermemory.

- [Introducing Wordcell](https://wordcell.io/blog/introducing-wordcell): Who

Wordcell suits, one saved rule traced to a cited search and graph answer,

and its limits.

- [How Wordcell uses Oh](https://wordcell.io/blog/how-wordcell-uses-oh): How

a graph answer carries a proof back to the Markdown files that support it.

## Source material

- Repository and packaged Agent Skill: https://github.com/hraness/wordcell

- README as Markdown: https://github.com/hraness/wordcell/blob/main/README.md

- Wordcell retrieval study: https://wordcell.io/docs/reranking#evidence-and-limits

- Wordcell and Oh integration: https://wordcell.io/docs/graph-authority#how-wordcell-and-oh-fit-together

- Oh's separate memory framework and benchmark evidence: https://oh.computer/#benchmarks

- Immutable releases: https://github.com/hraness/wordcell/releases

- npm mirror: https://www.npmjs.com/package/@hraness/wordcell

## Optional

- [sitemap](https://wordcell.io/sitemap.xml): Indexable HTML URLs.