@aaryanbindage/omnicontext 0.1.2 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -6
- package/dist/omnicontext.mjs +66 -45
- package/package.json +1 -1
- package/src/cli.js +36 -1
- package/src/context.js +17 -2
- package/src/mcp.js +116 -4
- package/src/store.js +154 -4
- package/src/sync.js +7 -0
package/README.md
CHANGED
|
@@ -30,7 +30,10 @@ Claude: Resuming Starfall (the Godot space roguelike). Last sessi
|
|
|
30
30
|
|
|
31
31
|
- **Knows you.** A profile (role, preferences, tools, facts) shared with every session. Claude adds to it when you tell it something lasting (`remember`).
|
|
32
32
|
- **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.
|
|
33
|
-
- **Resumes across devices.** `/omnicontext:handoff` saves a self-contained summary and next steps. On another machine, `/omnicontext:resume` picks it up
|
|
33
|
+
- **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.
|
|
34
|
+
- **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`).
|
|
35
|
+
- **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/](watch/).
|
|
36
|
+
- **Forgets on request.** "That's not true anymore" → `forget`.
|
|
34
37
|
- **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.
|
|
35
38
|
- **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.
|
|
36
39
|
|
|
@@ -44,7 +47,7 @@ Download from **[Releases](https://github.com/aaryanbindage/omnicontext/releases
|
|
|
44
47
|
|---|---|
|
|
45
48
|
| Windows | `OmniContext-Setup-x.y.z.exe` (installer) or `…-Windows-x64.zip` (portable) |
|
|
46
49
|
| macOS | `…-macOS-arm64.dmg` (Apple Silicon) / `…-macOS-x64.dmg` (Intel) |
|
|
47
|
-
| Linux | `…-Linux-x86_64.AppImage`
|
|
50
|
+
| Linux | `…-Linux-x86_64.AppImage` / `…-Linux-amd64.deb` (x64), `…-Linux-arm64.AppImage` / `…-Linux-arm64.deb` (ARM64, e.g. Raspberry Pi 4/5) |
|
|
48
51
|
|
|
49
52
|
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.
|
|
50
53
|
|
|
@@ -92,6 +95,9 @@ npm i -g @aaryanbindage/omnicontext
|
|
|
92
95
|
omnicontext project add "Starfall" --alias "my game" --tag godot --desc "2D space roguelike" --path .
|
|
93
96
|
omnicontext resolve "my game project"
|
|
94
97
|
omnicontext remember "Prefers TypeScript and short answers"
|
|
98
|
+
omnicontext forget "TypeScript"
|
|
99
|
+
omnicontext capture "try a grappling hook in level 3" --project starfall
|
|
100
|
+
omnicontext export backup.json # everything in one file; import with: omnicontext import backup.json
|
|
95
101
|
omnicontext sync --github # one-time: create a private repo and sync
|
|
96
102
|
```
|
|
97
103
|
|
|
@@ -119,14 +125,15 @@ You can do the same from the desktop app's **Sync & devices** tab. After that, s
|
|
|
119
125
|
| Tool | Purpose |
|
|
120
126
|
|---|---|
|
|
121
127
|
| `get_context` | Full briefing: profile, projects, open handoffs (for clients without hooks) |
|
|
122
|
-
| `get_profile` / `update_profile` / `remember` | Read and update what Claude knows about you |
|
|
128
|
+
| `get_profile` / `update_profile` / `remember` / `forget` | Read and update what Claude knows about you |
|
|
123
129
|
| `list_projects` / `get_project` / `upsert_project` / `add_project_note` | Manage projects, nicknames, per-device folders, notes |
|
|
124
130
|
| `resolve_project` | "my game project" → the matching project, ranked |
|
|
125
131
|
| `save_handoff` / `list_handoffs` / `resume_handoff` / `complete_handoff` | Cross-device resume |
|
|
126
|
-
| `
|
|
132
|
+
| `capture` / `list_inbox` / `file_inbox` | Quick captures (for example from the watch) and filing them |
|
|
133
|
+
| `search_memory` | Search the profile, notes, handoffs, and inbox |
|
|
127
134
|
| `sync_now` | Push and pull with your other devices |
|
|
128
135
|
|
|
129
|
-
It also provides the prompts `resume` and `handoff`.
|
|
136
|
+
It also provides the prompts `resume` and `handoff`, and the resources `omnicontext://profile`, `omnicontext://context` and `omnicontext://projects/{slug}`.
|
|
130
137
|
|
|
131
138
|
## Data format
|
|
132
139
|
|
|
@@ -134,7 +141,9 @@ It also provides the prompts `resume` and `handoff`.
|
|
|
134
141
|
~/.omnicontext/
|
|
135
142
|
profile.md # you — edit freely
|
|
136
143
|
projects/starfall.json # name, aliases, tags, description, repo, paths per device, notes
|
|
137
|
-
handoffs/<id>.json # title, summary, next steps, files, device, status
|
|
144
|
+
handoffs/<id>.json # title, summary, next steps, files, device, status, git state
|
|
145
|
+
inbox/<id>.json # quick captures waiting to be filed
|
|
146
|
+
snapshot.json # everything above in one file, written on sync (read by the watch app)
|
|
138
147
|
local.json # this device only (name, sync prefs) — not synced
|
|
139
148
|
```
|
|
140
149
|
|