Repository avatar
Other Tools
v0.3.0
active

omnicontext

io.github.aaryanbindage/omnicontext

Persistent cross-device memory for Claude: your profile, projects, and resumable handoffs.

Documentation

OmniContext logo

OmniContext

Persistent, cross-device memory for Claude.
Every Claude session — Claude Code, Claude Desktop, any MCP client, on any of your machines — knows who you are, what you're working on, and where you left off.

Download (Mac · Windows · Linux) · Claude Code plugin · MCP server · Website

npm CI MIT


You (on your laptop):  continue my game project
Claude:                Resuming Starfall (the Godot space roguelike). Last session on your desktop
                       you finished the enemy state machine; next up is the boss fight timings…

What it does

  • Knows you. A profile (role, preferences, tools, facts) shared with every session. Claude adds to it when you tell it something lasting (remember).
  • Knows your projects. Name them once, give them nicknames, and "my game project", "the website" or "that bot" resolve to the right one in any session. Each project keeps notes, its repo, and its folder on each device.
  • Resumes across devices. /omnicontext:handoff saves a self-contained summary and next steps, plus the git branch and commit and any uncommitted or unpushed work. On another machine, /omnicontext:resume picks it up, opens the project's folder on that device, and tells you how to get the checkout to the same state.
  • Inbox for quick thoughts. Dictate on your Apple Watch, or run omnicontext capture "…". The next Claude session offers to file each one as a profile fact or a project note (/omnicontext:inbox).
  • Apple Watch app. A standalone watchOS viewer that needs no iPhone. It shows open handoffs, projects and your profile, lets you mark handoffs done, and dictates captures. It talks straight to your private GitHub data repo. See watch/.
  • Knowledge graph, Obsidian-style. The desktop app's Graph tab draws everything in memory: you, projects, tags, devices, handoffs, facts, inbox and [[Topics]]. Projects link through shared tags and whenever one names another. Drag, zoom, search and filter, and click a node to see its connections. Claude can walk it with the related tool ("what else uses Godot?"), and the watch app can browse it too.
  • Forgets on request. "That's not true anymore" → forget.
  • Syncs without a cloud service. Your memory is a folder of plain Markdown and JSON files (~/.omnicontext) synced through a private git repo you own. Nothing goes to a third-party server.
  • Works everywhere. It's a Claude Code plugin with auto-injected context, an MCP server for Claude Desktop, Cursor, VS Code, Windsurf and Zed, a desktop app for Mac, Windows and Linux, and a CLI.

Install

Desktop app (Mac · Windows · Linux)

Download from Releases:

OSFile
WindowsOmniContext-Setup-x.y.z.exe (installer) or …-Windows-x64.zip (portable)
macOS…-macOS-arm64.dmg (Apple Silicon) / …-macOS-x64.dmg (Intel)
Linux…-Linux-x86_64.AppImage / …-Linux-amd64.deb (x64), …-Linux-arm64.AppImage / …-Linux-arm64.deb (ARM64, e.g. Raspberry Pi 4/5)

The app lets you edit your profile, projects and handoffs, set up sync, and connect Claude Code and Claude Desktop with one click. It stays in the tray and syncs in the background.

macOS builds aren't notarized yet. If macOS says the app is damaged, run xattr -cr /Applications/OmniContext.app.

Claude Code plugin

/plugin marketplace add aaryanbindage/omnicontext
/plugin install omnicontext@omnicontext

Requires Node.js 18+. You get:

SessionStart hookinjects your profile, project index, the current project, and open handoffs
SessionEnd hooksyncs your memory to your other devices
/omnicontext:handoff [title]save the current work so it can be resumed anywhere
/omnicontext:resume [project]continue the latest (or a named) handoff
/omnicontext:remember <fact>remember something about you or a project
/omnicontext:project [name aka nickname]register this folder as a project
/omnicontext:syncsync now
MCP tools + skillClaude resolves "my X project", saves notes and handoffs

Claude Desktop & other MCP clients

One click: download omnicontext.mcpb from Releases and open it with Claude Desktop. You can also use the desktop app (Connect Claude → Install) or run npx @aaryanbindage/omnicontext install claude-desktop.

Manually (Claude Desktop, Cursor, Windsurf, VS Code, Zed, Cline and others):

{
  "mcpServers": {
    "omnicontext": { "command": "npx", "args": ["-y", "@aaryanbindage/omnicontext", "mcp"] }
  }
}

CLI

npm i -g @aaryanbindage/omnicontext
omnicontext project add "Starfall" --alias "my game" --tag godot --desc "2D space roguelike" --path .
omnicontext resolve "my game project"
omnicontext remember "Prefers TypeScript and short answers"
omnicontext forget "TypeScript"
omnicontext capture "try a grappling hook in level 3" --project starfall
omnicontext export backup.json     # everything in one file; import with: omnicontext import backup.json
omnicontext sync --github          # one-time: create a private repo and sync

Sync your devices

On your first device:

omnicontext sync --github                  # needs the GitHub CLI (gh auth login); creates <you>/omnicontext-data (private)
# or
omnicontext sync --remote <any git url you own>

On every other device, connect the same repo:

omnicontext sync --remote https://github.com/<you>/omnicontext-data.git
omnicontext device "MacBook"               # optional: a friendly device name

You can do the same from the desktop app's Sync & devices tab. After that, sync runs on its own: at the start and end of each Claude Code session, a few seconds after the MCP server makes a change, and every few minutes while the desktop app is open. Each record is its own file, so two devices rarely conflict. When they do, the local version wins, and git history keeps everything.

MCP tools

ToolPurpose
get_contextFull briefing: profile, projects, open handoffs (for clients without hooks)
get_profile / update_profile / remember / forgetRead and update what Claude knows about you
list_projects / get_project / upsert_project / add_project_noteManage projects, nicknames, per-device folders, notes
resolve_project"my game project" → the matching project, ranked
save_handoff / list_handoffs / resume_handoff / complete_handoffCross-device resume
capture / list_inbox / file_inboxQuick captures (for example from the watch) and filing them
relatedWalk the knowledge graph from a project, #tag, device or [[topic]]
search_memorySearch the profile, notes, handoffs, and inbox
sync_nowPush and pull with your other devices

It also provides the prompts resume and handoff, and the resources omnicontext://profile, omnicontext://context and omnicontext://projects/{slug}.

Data format

~/.omnicontext/
  profile.md               # you — edit freely
  projects/starfall.json   # name, aliases, tags, description, repo, paths per device, notes
  handoffs/<id>.json       # title, summary, next steps, files, device, status, git state
  inbox/<id>.json          # quick captures waiting to be filed
  snapshot.json            # everything above in one file, written on sync (read by the watch app)
  local.json               # this device only (name, sync prefs) — not synced

Set OMNICONTEXT_HOME to use a different folder. You can also put the folder in Dropbox, iCloud or OneDrive instead of using git sync.

Privacy

Everything stays on your machines and in the git remote you choose. OmniContext has no server, no telemetry, and no account. Don't store secrets in it. The instructions it gives Claude say the same.

Development

npm install
npm test
npm run build          # bundles dist/omnicontext.mjs (used by the plugin, the app, and npm)
cd app && npm install && npm start     # run the desktop app

Releases: push a v* tag. GitHub Actions builds the Windows, macOS and Linux apps and the .mcpb bundle, and publishes to npm.

License

MIT © aaryanbindage

NPM
@aaryanbindage/omnicontext
Install Command
npm install @aaryanbindage/omnicontext