ultracontext 1.2.0 → 1.3.1

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 CHANGED
@@ -4,7 +4,12 @@
4
4
  </a>
5
5
  </p>
6
6
 
7
- <h3 align="center">Context infrastructure for AI agents.</h3>
7
+ <h3 align="center">Same context. Everywhere.</h3>
8
+
9
+ <p align="center">
10
+ Start on Claude Code. Continue on Codex.<br/>
11
+ Open source, realtime and invisible context infrastructure for the ones shipping at inference speed.
12
+ </p>
8
13
 
9
14
  <p align="center">
10
15
  <a href="https://ultracontext.ai/docs">Documentation</a> ·
@@ -38,50 +43,54 @@
38
43
 
39
44
  ---
40
45
 
41
- <h2 align="center">All agents. One context.</h2>
46
+ ![ultracontext-gif](https://github.com/user-attachments/assets/be73afe5-161d-4fa3-8f4d-c4987fe63cb4)
42
47
 
43
- Auto-capture and share your agents' context everywhere. Realtime. Open source.
48
+ What Claude Code knows, Codex doesn't. What your teammate is shipping right now? Your agent has no idea.
44
49
 
45
- ![ultracontext-gif](https://github.com/user-attachments/assets/be73afe5-161d-4fa3-8f4d-c4987fe63cb4)
50
+ UltraContext captures every agent's context in realtime and makes it available to all of them. It's like having a personal context engineer everywhere. Continue a session in a different agent, or just ask what's happeming.
46
51
 
47
- Everyone is shipping with agents. Few are shipping with agents together.
52
+ For example:
48
53
 
49
- Multiple people, multiple agents, multiple machines. Our contexts are spread everywhere. There's no standard for context engineering. No infrastructure to build on. No fundamental building blocks to agree on. So we decided to make it.
54
+ - *"Codex, grab the last plan Claude Code made and implement it."*
55
+ - *"What's the team building today?"*
56
+ - *"What is Alex working on in Codex right now?"*
50
57
 
51
- UltraContext is the context infrastructure. The API gives you git-like primitives for context engineering. The Hub lets you auto-capture, share, and collaborate across agents in realtime.
58
+ Open source. Framework-agnostic. Customizable via the git-like Context API.
52
59
 
53
- ## Install
60
+ ## Features
54
61
 
55
- Requires Node >= 22.
62
+ | CLI | Auto-ingest Claude Code, Codex, and OpenClaw sessions with a terminal dashboard. |
63
+ | --- | --- |
64
+ | MCP Server | Share context everywhere. Built into the API, or run standalone via stdio. |
65
+ | Context API | Git-like context engineering API. Store, version, and retrieve agent context with zero complexity. |
56
66
 
57
- ```bash
58
- npm install -g ultracontext
59
- ```
67
+ ---
60
68
 
61
- ## The Hub
69
+ ## How it works
62
70
 
63
- **All agents. One context.**
71
+ 1. **Start the daemon.** It captures all your agents' context in realtime.
64
72
 
65
- The Hub lets you auto-capture, share, and collaborate across agents in realtime.
73
+ 2. **Add the MCP server.** Any agent gets full awareness of every other agent.
66
74
 
67
- ### Features
75
+ 3. **That's it.** Ask questions, continue sessions, fork — your context is everywhere.
68
76
 
69
- - **Auto-capture** — Ingests your agents' context in realtime. Zero config.
70
- - **Switch between agents** — Pick up where one agent left off with another.
71
- - **Collaborate** — Share contexts across your team. See what everyone sees. Realtime.
72
- - **Fork & clone** — Continue contexts while preserving the full history.
73
- - **Own your data** — Open source. Your contexts. Your rules.
77
+ ## Install
74
78
 
75
- ### How it works
79
+ Requires Node >= 22.
76
80
 
77
- 1. A daemon runs in the background, watching your agents.
78
- 2. Contexts are ingested in realtime.
79
- 3. Your dashboard gets updated.
81
+ ```bash
82
+ npm install -g ultracontext
83
+ ```
80
84
 
81
- ### Quick Start
85
+ ## Quick Start
82
86
 
83
87
  ```bash
84
88
  ultracontext # start daemon + open dashboard
89
+ ```
90
+
91
+ That's it. The daemon watches your agents, ingests context in realtime, and the dashboard shows everything.
92
+
93
+ ```bash
85
94
  ultracontext config # run setup wizard
86
95
  ultracontext start # start daemon only
87
96
  ultracontext stop # stop daemon
@@ -89,36 +98,22 @@ ultracontext status # check if daemon is running
89
98
  ultracontext tui # open dashboard only
90
99
  ```
91
100
 
92
- The default `ultracontext` command does everything: checks the daemon, starts it if needed, and opens the dashboard.
93
-
94
- When you open an existing session, it forks the context — the original is always preserved and automatically versioned. A local caching layer prevents duplicate context creations and appends.
95
-
96
- Add your own agents and extend behavior with the Context API. ([Docs here](https://ultracontext.ai/docs/))
101
+ ## Context API
97
102
 
98
- ## The API
99
-
100
- **Context engineering built like Git.**
101
-
102
- The API gives you git-like primitives for context engineering, without the complexity.
103
-
104
- ### Features
103
+ For builders who want to go deeper. Git-like primitives for context engineering.
105
104
 
106
105
  - **Five methods** — Create, get, append, update, delete. That's it.
107
106
  - **Automatic versioning** — Every change creates a new version. Full history out of the box.
108
107
  - **Time-travel** — Jump to any point in your context history.
109
108
  - **Framework-agnostic** — Works with any LLM framework. No vendor lock-in.
110
109
 
111
- The simplest way to control what your agents see. Replace messages, compact long context, replay decisions and roll back mistakes — all with a single API call.
112
-
113
- Use the API standalone to build your own agents, or to extend existing ones in UltraContext.
114
-
110
+ Use the API standalone to build your own agents, or extend existing ones in UltraContext.
115
111
 
116
112
  | SDK | Install | Source |
117
113
  | --------------------- | -------------------------- | ------------------------------------ |
118
114
  | JavaScript/TypeScript | `npm install ultracontext` | [apps/js-sdk](./apps/js-sdk) |
119
115
  | Python | `pip install ultracontext` | [apps/python-sdk](./apps/python-sdk) |
120
116
 
121
-
122
117
  ### JavaScript/TypeScript
123
118
 
124
119
  ```bash
@@ -170,9 +165,8 @@ response = generate_text(model=model, messages=uc.get(ctx["id"])["data"])
170
165
 
171
166
  [![Star History Chart](https://api.star-history.com/svg?repos=ultracontext/ultracontext-node&type=date&legend=top-left)](https://www.star-history.com/#ultracontext/ultracontext-node&type=date&legend=top-left)
172
167
 
173
-
174
168
  ## Documentation
175
169
 
176
- - [Quickstart](https://ultracontext.ai/docs/quickstart/nodejs) — Get running in 2 minutes
170
+ - [Quickstart](https://ultracontext.ai/docs/quickstart) — Get running in 2 minutes
177
171
  - [Guides](https://ultracontext.ai/docs/guides/store-retrieve-contexts) — Practical patterns for common use cases
178
- - [API Reference](https://ultracontext.ai/docs/api-reference/introduction) — Full endpoint documentation
172
+ - [API Reference](https://ultracontext.ai/docs/api-reference/introduction) — Full endpoint documentation
@@ -313,18 +313,18 @@ async function checkForUpdate() {
313
313
  if (latest && isNewer(latest, current)) printUpdateNotice(current, latest);
314
314
  }
315
315
  async function launchDaemonSDK() {
316
- const { launchDaemon } = await import("../launcher-VTbHuuaQ.mjs");
316
+ const { launchDaemon } = await import("../launcher-DeTwUGTs.mjs");
317
317
  await launchDaemon({
318
318
  entryPath: fileURLToPath(new URL("./sdk-daemon.mjs", import.meta.url)),
319
319
  diagnosticsHint: "DAEMON_VERBOSE=1 ultracontext start"
320
320
  });
321
321
  }
322
322
  async function runCtlSDK() {
323
- const { runCtl } = await import("../ctl-DaIi3tUU.mjs");
323
+ const { runCtl } = await import("../ctl-3wE5-uEy.mjs");
324
324
  await runCtl();
325
325
  }
326
326
  async function launchTuiSDK() {
327
- const { tuiBoot } = await import("../tui-BwpUi10R.mjs");
327
+ const { tuiBoot } = await import("../tui-BmUdW0Nf.mjs");
328
328
  await tuiBoot({
329
329
  assetsRoot: path.resolve(__dirname, "..", ".."),
330
330
  offlineNotice: "Daemon offline. Run: ultracontext start"