What Is It
SharedContext is a local-first memory layer for LLM agents. It gives Cursor, Claude Code, and Codex persistent memory that you own, synced to Arweave so it follows you across sessions and machines.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
SharedContext is a local-first memory layer for LLM agents. It gives Cursor, Claude Code, and Codex persistent memory that you own, synced to Arweave so it follows you across sessions and machines.
MCP server that gives AI coding assistants persistent cross-client memory. Facts and conversations stored in SQLite, encrypted with AES-256-GCM, synced to Arweave. No server, no account, recoverable with a 12-word phrase.
Your AI assistant forgets everything the moment a session ends. Project decisions, coding preferences, architectural context — all gone. You re-explain the same things every day.
SharedContext fixes that. It runs as an MCP server that your AI client connects to. Agents store and recall facts through MCP tools. A background watcher syncs your conversation history. Everything is encrypted client-side and uploaded to Arweave. Restore it all on a new machine with a 12-word recovery phrase.
Your AI memory is fragmented:
~/.cursor/projects/~/.claude/projects/None of them talk to each other. None of them persist structured knowledge. None of them let you move to a new machine and pick up where you left off.
SharedContext collapses all of that into one encrypted, portable layer that every client reads from and writes to. One memory. One identity. One place to look.
SharedContext is early (v0.1.x). It works, it's tested, but it's not battle-hardened yet.
Supported clients: Cursor, Claude Desktop, Claude CLI, Codex
Current limitations:
A 12-word recovery phrase deterministically derives a secp256k1 keypair. The phrase + a random salt derive an AES encryption key via Argon2id. The private key is stored encrypted at ~/.sharedcontext/identity.enc. The phrase is stored in the OS keychain for background MCP access.
SQLite is the runtime store. Three tables:
facts — structured memory (key/value with tags, scope, confidence)pending_deletes — tombstones queued for remote syncmeta — version cursors, offsets, sync stateAll reads are local. Fast and offline-capable.
dirty=1upsert / delete)~/.cursor/projects/ and ~/.claude/projects/ for changesDelta-only uploads keep network writes small.
init --existingMalformed, unsigned, or bad-signature payloads are skipped.
npm install -g ai-sharedcontext
sharedcontext init
This generates a 12-word recovery phrase, derives your identity, creates ~/.sharedcontext/, and auto-configures any detected AI clients (Cursor, Claude, Codex).
Write down the recovery phrase. It's the only way to restore your context.
Once initialized, your AI client connects to SharedContext automatically via MCP. No extra steps.
Storing facts — the agent calls store_fact when you express preferences or make decisions:
You: "We're using Drizzle ORM with PostgreSQL for this project"
→ Agent stores: key=project:database:orm value="Drizzle ORM with PostgreSQL" tags=["database","orm","drizzle"]
Recalling context — the agent calls recall_context to retrieve relevant facts:
You: "What database setup are we using?"
→ Agent recalls: project:database:orm → "Drizzle ORM with PostgreSQL"
Recalling conversations — the agent calls recall_conversation to find past sessions:
You: "Continue the conversation about the auth refactor"
→ Agent retrieves the most relevant conversation matching "auth refactor"
sharedcontext init --existing
Enter your 12-word phrase. SharedContext queries Arweave, downloads your encrypted shards, verifies signatures, decrypts, and rebuilds local state.
If auto-setup didn't configure your client, run one of:
sharedcontext setup --cursor
sharedcontext setup --claude
sharedcontext setup --claude-cli
sharedcontext setup --codex
Then restart the client app.
Share a conversation with someone (or with yourself on another machine):
# 1. List your conversations
sharedcontext list conversations
# 2. Share one by ID
sharedcontext share <conversationId>
# → outputs: sharedcontext://share/<token>
# 3. Import on the other end
sharedcontext sync sharedcontext://share/<token>
The conversation is encrypted with a random key embedded in the token. Only someone with the full URL can decrypt it. The encrypted blob lives on Arweave — the link works forever.
What this means: Arweave stores opaque encrypted blobs. Without your recovery phrase (or a share token for shared conversations), the data is unreadable. There is no server, no account, no API key. You are the only keyholder.
Shorthand: sc is an alias for sharedcontext.
src/
├── cli/ # Command workflows (init, setup, share, sync, etc.)
├── core/ # Crypto, identity, storage, sync engine, parsers, watcher
│ ├── backends/ # Arweave upload backend (Turbo)
│ └── parsers/ # Cursor transcript + Claude Code JSONL parsers
├── mcp/ # MCP server with tool definitions (store_fact, recall_context, etc.)
└── test/ # Unit and integration tests
git clone https://github.com/Eversmile12/sharme.git
cd sharme
npm install
npm run build
npm test
PRs welcome. Keep changes focused and tests passing.
MIT
MCP server that gives AI coding assistants persistent cross-client memory. Facts and conversations stored in SQLite, encrypted with AES-256-GCM, synced to Arweave. No server, no account, recoverable w
總覽
MCP server that gives AI coding assistants persistent cross-client memory. Facts and conversations stored in SQLite, encrypted with AES-256-GCM, synced to Arweave. No server, no account, recoverable with a 12-word phrase.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Sharedcontext 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 MCP server that gives AI coding assistants persistent cross-client memory. Facts and conversations stored in SQLite, encrypted with AES-256-GCM, synced to Arweave. No server, no account, recoverable with a 12-word phrase.