These docs describe v0.27.0. The install commands use v0.26.0, the newest release this site has verified. Features added after v0.26.0 need the newer version; see the release notes.
Wordcell documentation
Start with the tutorial if you are new to Wordcell. How-to guides each finish one task, the reference lists exact commands, formats, and limits, and the explanation pages cover the design and what was measured. The product overview has everything on one page.
Install
- macOS
- Linux
- Windows
macOS
bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.26.0/hraness-wordcell-0.26.0.tgznpm install --global --ignore-scripts @hraness/wordcell@0.26.0
Linux
bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.26.0/hraness-wordcell-0.26.0.tgznpm install --global --ignore-scripts @hraness/wordcell@0.26.0
Windows
bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.26.0/hraness-wordcell-0.26.0.tgznpm install --global --ignore-scripts @hraness/wordcell@0.26.0
wordcell --helpRequires Bun 1.3.14 or newer and Git. Walk through the first vault or read the installation reference.
Tutorials
Learn the loop end to end on a small vault.
- Get started with Wordcell
Install the CLI, create a vault, save a decision, find it, connect it, and preview a published page.
How-to guides
Finish one task, such as capturing a web page, publishing a site, or searching several vaults.
- Use Wordcell with a coding agent
Set up, query, maintain, and revise repository memory with a coding agent.
- Connect Wordcell to your coding agent
Register Wordcell’s local MCP server with Claude Code, Codex, or Cursor, check that the agent can start it, and fix the errors you are likely to see.
- Use Wordcell with an existing Obsidian vault
Search an Obsidian vault in place, see which links, tags, and attachments Wordcell reads, and serve the vault to a coding agent without changing it.
- Migrate from Supermemory
Export your Supermemory documents and memory entries, import them as Markdown notes, and see what does not transfer.
- Capture web content
Save a page, thread, or video as Markdown with local copies of its assets and a record of how it was captured.
- Capture PDF documents
Turn a local or remote PDF into a Markdown bundle with the original file, headings, and extracted evidence.
- Publish a static site
Select notes, inspect the dry-run report, build the site, and choose how to host it.
- Search several vaults together
Search and link across only the vaults you explicitly select and authorize.
- Sync a vault with Git
Keep one vault current on several machines with a private Git repository and a script that commits and pushes on a schedule.
- Use hosted reranking
The source version can reorder up to 25 results with Cloudflare Clef. If the provider fails, you keep the original order.
- Release and verify Wordcell
How maintainers cut a release, and how you can check a downloaded archive's signatures and provenance.
Reference
Exact commands, formats, interfaces, and limits.
- Installation and command reference
Exact interfaces, SDK imports, optional adapters, the vault format, and prerequisites.
- Hosted publication API
Endpoints, MCP tools, tokens, and limits for hosting a site built from selected notes on wordcell.io.
- Hosted publication operations
Publish against an expected revision and recover the exact result after an interrupted request.
Explanation
Why the vault works this way and what was measured.
- Why Wordcell keeps everything in Markdown
Why Wordcell keeps everything in Markdown files, and how its storage, search, graph, and capture fit together.
- Why agent memory belongs in Markdown beside the repository
Why durable agent memory belongs in inspectable Markdown beside the repository.
- Choose a Markdown knowledge or agent memory tool
Markdown knowledge tools and agent memory services compared with Wordcell, using each project's own primary documentation.
- Reproduce Wordcell’s context experiments
Reproduce source-level experiments on excerpt selection and packed context, using the frozen inputs and recorded results.
- Query the derived graph
Run named graph queries, read their proofs and limits, and rebuild the local graph cache.
- Markdown-memory retrieval pilot
A historical comparison of exact and hybrid search on a frozen repository corpus, with measurements and uncertainty.