@aaryanbindage/omnicontext 0.1.3 → 0.3.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 +16 -5
- package/dist/omnicontext.mjs +77 -46
- package/package.json +1 -1
- package/src/cli.js +63 -1
- package/src/context.js +17 -2
- package/src/graph.js +130 -0
- package/src/index.js +1 -0
- package/src/mcp.js +146 -4
- package/src/store.js +164 -4
- package/src/sync.js +7 -0
package/README.md
CHANGED
|
@@ -30,7 +30,11 @@ 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
|
+
- **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.
|
|
37
|
+
- **Forgets on request.** "That's not true anymore" → `forget`.
|
|
34
38
|
- **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
39
|
- **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
40
|
|
|
@@ -92,6 +96,9 @@ npm i -g @aaryanbindage/omnicontext
|
|
|
92
96
|
omnicontext project add "Starfall" --alias "my game" --tag godot --desc "2D space roguelike" --path .
|
|
93
97
|
omnicontext resolve "my game project"
|
|
94
98
|
omnicontext remember "Prefers TypeScript and short answers"
|
|
99
|
+
omnicontext forget "TypeScript"
|
|
100
|
+
omnicontext capture "try a grappling hook in level 3" --project starfall
|
|
101
|
+
omnicontext export backup.json # everything in one file; import with: omnicontext import backup.json
|
|
95
102
|
omnicontext sync --github # one-time: create a private repo and sync
|
|
96
103
|
```
|
|
97
104
|
|
|
@@ -119,14 +126,16 @@ You can do the same from the desktop app's **Sync & devices** tab. After that, s
|
|
|
119
126
|
| Tool | Purpose |
|
|
120
127
|
|---|---|
|
|
121
128
|
| `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 |
|
|
129
|
+
| `get_profile` / `update_profile` / `remember` / `forget` | Read and update what Claude knows about you |
|
|
123
130
|
| `list_projects` / `get_project` / `upsert_project` / `add_project_note` | Manage projects, nicknames, per-device folders, notes |
|
|
124
131
|
| `resolve_project` | "my game project" → the matching project, ranked |
|
|
125
132
|
| `save_handoff` / `list_handoffs` / `resume_handoff` / `complete_handoff` | Cross-device resume |
|
|
126
|
-
| `
|
|
133
|
+
| `capture` / `list_inbox` / `file_inbox` | Quick captures (for example from the watch) and filing them |
|
|
134
|
+
| `related` | Walk the knowledge graph from a project, #tag, device or [[topic]] |
|
|
135
|
+
| `search_memory` | Search the profile, notes, handoffs, and inbox |
|
|
127
136
|
| `sync_now` | Push and pull with your other devices |
|
|
128
137
|
|
|
129
|
-
It also provides the prompts `resume` and `handoff`.
|
|
138
|
+
It also provides the prompts `resume` and `handoff`, and the resources `omnicontext://profile`, `omnicontext://context` and `omnicontext://projects/{slug}`.
|
|
130
139
|
|
|
131
140
|
## Data format
|
|
132
141
|
|
|
@@ -134,7 +143,9 @@ It also provides the prompts `resume` and `handoff`.
|
|
|
134
143
|
~/.omnicontext/
|
|
135
144
|
profile.md # you — edit freely
|
|
136
145
|
projects/starfall.json # name, aliases, tags, description, repo, paths per device, notes
|
|
137
|
-
handoffs/<id>.json # title, summary, next steps, files, device, status
|
|
146
|
+
handoffs/<id>.json # title, summary, next steps, files, device, status, git state
|
|
147
|
+
inbox/<id>.json # quick captures waiting to be filed
|
|
148
|
+
snapshot.json # everything above in one file, written on sync (read by the watch app)
|
|
138
149
|
local.json # this device only (name, sync prefs) — not synced
|
|
139
150
|
```
|
|
140
151
|
|