@tinchu0/knitt 0.1.0-beta.4 → 0.1.0-beta.6
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 +24 -15
- package/dist/apps/server/src/cloud-picker.js +245 -0
- package/dist/apps/server/src/http-gateway.js +1 -1
- package/dist/apps/server/src/main.js +6 -2
- package/dist/apps/server/src/onboarding.js +266 -0
- package/dist/apps/server/src/plugin-bootstrap.js +82 -0
- package/dist/apps/server/src/plugin-hook.js +51 -0
- package/dist/apps/server/src/plugin-main.js +10 -0
- package/dist/apps/server/src/server.js +108 -29
- package/dist/packages/adapters/src/cli.js +19 -2
- package/dist/packages/adapters/src/handoff.js +10 -6
- package/dist/packages/adapters/src/histories.js +221 -0
- package/dist/packages/adapters/src/history-time.js +10 -0
- package/dist/packages/adapters/src/hooks.js +8 -8
- package/dist/packages/adapters/src/picker.js +2 -1
- package/dist/packages/adapters/src/question-ui.js +37 -0
- package/dist/packages/adapters/src/scope.js +9 -3
- package/dist/packages/adapters/src/server-name.js +5 -0
- package/dist/packages/adapters/src/transcript.js +2 -0
- package/dist/packages/cloud/src/client.js +40 -0
- package/dist/packages/cloud/src/local-sync.js +300 -0
- package/dist/packages/installer/src/antigravity.js +90 -0
- package/dist/packages/installer/src/cli.js +77 -30
- package/dist/packages/installer/src/cloud-cli.js +199 -0
- package/dist/packages/installer/src/connections.js +37 -9
- package/dist/packages/installer/src/runtime.js +2 -2
- package/dist/packages/memory/src/store.js +36 -0
- package/dist/skills/knit/SKILL.md +27 -5
- package/docs/clients/connector-setup.md +1 -1
- package/docs/clients/npm-installation.md +28 -12
- package/docs/clients/support-matrix.md +12 -0
- package/docs/usage.md +28 -29
- package/package.json +6 -3
package/docs/usage.md
CHANGED
|
@@ -16,26 +16,15 @@ git --version
|
|
|
16
16
|
|
|
17
17
|
The installer includes native Linux, macOS and Windows paths. Windows hooks require built-in Windows PowerShell; macOS and Linux use POSIX hooks. Linux checks passed locally; native Windows/macOS runs still need confirmation. Client configuration support does not guarantee that every client has passed a live handoff test. See the [client support evidence](clients/support-matrix.md).
|
|
18
18
|
|
|
19
|
-
## 2.
|
|
19
|
+
## 2. Run the package
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
From the Knitt source checkout:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm ci
|
|
27
|
-
npm run check
|
|
28
|
-
npm run build
|
|
29
|
-
npm pack
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
For version `0.1.0-beta.1`, this produces `tinchu0-knitt-0.1.0-beta.1.tgz`. Set its absolute path so the following commands work from any folder:
|
|
21
|
+
Use the published beta through npm’s `next` channel:
|
|
33
22
|
|
|
34
23
|
```bash
|
|
35
|
-
|
|
24
|
+
npx @tinchu0/knitt@latest --version
|
|
36
25
|
```
|
|
37
26
|
|
|
38
|
-
|
|
27
|
+
No source checkout is needed. To test a source build instead, see [local tarball installation](clients/npm-installation.md).
|
|
39
28
|
|
|
40
29
|
## 3. Connect your project
|
|
41
30
|
|
|
@@ -44,7 +33,7 @@ Replace `/absolute/path/to/your-project` below with the Git repository whose con
|
|
|
44
33
|
First preview the configuration:
|
|
45
34
|
|
|
46
35
|
```bash
|
|
47
|
-
npx
|
|
36
|
+
npx @tinchu0/knitt@latest setup \
|
|
48
37
|
--workspace /absolute/path/to/your-project \
|
|
49
38
|
--client codex --client antigravity \
|
|
50
39
|
--preview
|
|
@@ -53,17 +42,16 @@ npx --yes --package "$KNITT_TARBALL" knitt setup \
|
|
|
53
42
|
Then install:
|
|
54
43
|
|
|
55
44
|
```bash
|
|
56
|
-
npx
|
|
45
|
+
npx @tinchu0/knitt@latest setup \
|
|
57
46
|
--workspace /absolute/path/to/your-project \
|
|
58
|
-
--client codex --client antigravity
|
|
59
|
-
--package "$KNITT_TARBALL"
|
|
47
|
+
--client codex --client antigravity
|
|
60
48
|
```
|
|
61
49
|
|
|
62
50
|
Review the displayed changes and confirm in the terminal. For noninteractive setup, add `--yes` after `setup`; the outer `npx --yes` only approves npx's package prompt.
|
|
63
51
|
|
|
64
52
|
Supported `--client` values are `codex`, `claude-code`, `antigravity`, and `claude-desktop`. Repeat the flag for each client you use. Running setup without `--workspace` and `--client` asks for them interactively.
|
|
65
53
|
|
|
66
|
-
|
|
54
|
+
Setup installs a persistent runtime matching the CLI version. Connected agents use it independently of npx's temporary cache.
|
|
67
55
|
|
|
68
56
|
Restart connected agents, open the target project, and approve their normal MCP and hook trust prompts. Claude Desktop needs an extra manual step described below.
|
|
69
57
|
|
|
@@ -79,7 +67,7 @@ If your client does not expose slash skills, ask:
|
|
|
79
67
|
|
|
80
68
|
> Use Knitt's shared-memory connection to open the conversation picker. Let me choose a chat, then retrieve its checkpoint and summarize the last progress and next step.
|
|
81
69
|
|
|
82
|
-
Choose the source conversation
|
|
70
|
+
Choose the source conversation inside your coding interface. Antigravity opens its selectable question UI; click the conversation you want. Clients supporting native forms can show those directly. No browser or separate terminal is required for a connected coding client. Knitt requires the active folder on each coding-picker call and rejects a connection for a different project. The picker shows the project folder above its choices. It discovers local **Claude Code, Codex and Antigravity histories** belonging to that repository, including linked worktrees. It excludes the agent you are using, labels each source, and offers only the four most recent matching chats, newest first. It does not browse remote Claude or ChatGPT account history.
|
|
83
71
|
|
|
84
72
|
After selection, the agent calls `get_context` and shows the restored checkpoint. Review it, then give a concrete instruction, for example:
|
|
85
73
|
|
|
@@ -95,7 +83,7 @@ The agent can use `search_memory` and `get_evidence` to retrieve details beyond
|
|
|
95
83
|
|
|
96
84
|
## 5. Preserve progress
|
|
97
85
|
|
|
98
|
-
For Codex, Claude Code, and Antigravity, setup installs startup and stop hooks. After
|
|
86
|
+
For Codex, Claude Code, and Antigravity, setup installs startup and stop hooks. After project sync consent, supported history is imported privately independently of source selection. Local continuation memory still captures into its selected source scope when the client runs the capture hooks. Capture depends on client support and hook trust; an installed configuration alone does not prove capture is working.
|
|
99
87
|
|
|
100
88
|
You can also ask the agent to save a checkpoint explicitly:
|
|
101
89
|
|
|
@@ -107,6 +95,8 @@ Checkpoints are reference material: inspect current files and branch state befor
|
|
|
107
95
|
|
|
108
96
|
## Claude Desktop, ChatGPT, and Claude web
|
|
109
97
|
|
|
98
|
+
**Antigravity:** setup automatically registers and verifies a project-specific memory server in `~/.gemini/config/mcp_config.json`, preserving existing servers. Restart Antigravity and use `/knit` in a fresh chat. Choose a conversation inside the same coding interface. Antigravity uses its selectable question UI; clients with native MCP forms can use those. Several projects can coexist; startup hooks identify the matching server. Update, rollback and uninstall manage Knitt’s unchanged entries. Use `--antigravity-config PATH` during setup if your installation uses another location; subsequent lifecycle commands remember that path.
|
|
99
|
+
|
|
110
100
|
**Claude Desktop:** select `--client claude-desktop` during setup. Merge the generated project's `.memory/connectors/claude-desktop.json` `mcpServers` entry into Desktop's local MCP settings, then restart Desktop. Knitt generates the fragment; it does not perform this merge for you.
|
|
111
101
|
|
|
112
102
|
In a new ordinary chat, ask the agent to call `start_session`, then `choose_conversation`, wait for your selection, and call `get_context`. Use the session ID returned for that chat. Ask for `save_memory` after substantive progress.
|
|
@@ -117,12 +107,12 @@ Local memory lives on one machine. Connecting another machine or using an identi
|
|
|
117
107
|
|
|
118
108
|
## Manage your installation
|
|
119
109
|
|
|
120
|
-
Use the same
|
|
110
|
+
Use the same npm channel and, if configured, the same `--home /absolute/path` for all commands.
|
|
121
111
|
|
|
122
112
|
Check the installation:
|
|
123
113
|
|
|
124
114
|
```bash
|
|
125
|
-
npx
|
|
115
|
+
npx @tinchu0/knitt@latest doctor
|
|
126
116
|
```
|
|
127
117
|
|
|
128
118
|
`configured` means local paths and managed settings passed inspection. It does not verify client login, trust approval, or a live handoff.
|
|
@@ -138,13 +128,13 @@ npx --yes --package "$KNITT_NEXT_TARBALL" knitt update \
|
|
|
138
128
|
Return to the previous runtime, if an earlier installation exists:
|
|
139
129
|
|
|
140
130
|
```bash
|
|
141
|
-
npx
|
|
131
|
+
npx @tinchu0/knitt@latest rollback --yes
|
|
142
132
|
```
|
|
143
133
|
|
|
144
134
|
Disconnect one project:
|
|
145
135
|
|
|
146
136
|
```bash
|
|
147
|
-
npx
|
|
137
|
+
npx @tinchu0/knitt@latest uninstall \
|
|
148
138
|
--workspace /absolute/path/to/your-project --yes
|
|
149
139
|
```
|
|
150
140
|
|
|
@@ -155,14 +145,14 @@ Uninstall restores unchanged managed settings while retaining user edits, the ru
|
|
|
155
145
|
| Symptom | What to check |
|
|
156
146
|
| --- | --- |
|
|
157
147
|
| No shared-memory tools or `/knit` | Restart the client in the connected project. Check MCP and hook trust prompts, then run `doctor`. |
|
|
158
|
-
| No conversations in the picker | Confirm
|
|
159
|
-
| Client cannot show a selection form |
|
|
148
|
+
| No conversations in the picker | Confirm another coding agent has a local history for this repository or its worktrees. The current agent’s own chats are excluded. Try searching the source title. Remote account histories are not imported. |
|
|
149
|
+
| Client cannot show a selection form | The agent must invoke the application’s native question tool with Knitt’s returned options. A printed list is not the picker. If the question tool is unavailable, native selection is unavailable in that session. Remote web connectors may use a browser picker. |
|
|
160
150
|
| “No chat selected” | Open the picker and choose a conversation in this session before retrieving or saving context. |
|
|
161
151
|
| Missing startup session ID | Reload the project's memory connection and start a fresh session. Ordinary chat clients use `start_session`; do not invent an ID. |
|
|
162
152
|
| “Wrong repository” or “different conversation” | Open the intended project and choose its chat in the current session. |
|
|
163
153
|
| Unmanaged or modified connector conflict | Review the named configuration file. Existing legacy or manually edited settings are not automatically overwritten. See the lifecycle guide before migrating. |
|
|
164
154
|
| Missing runtime path after changing Node | Rerun setup using the current Node installation. Generated executable paths are absolute. |
|
|
165
|
-
| Recent work is absent | Check
|
|
155
|
+
| Recent work is absent | Check project consent, running adapter/hook trust and sync status. For selected local memory, check the `/knit` selection or an explicit `save_memory` call. |
|
|
166
156
|
|
|
167
157
|
### Source-checkout fallback: Antigravity to Codex
|
|
168
158
|
|
|
@@ -177,3 +167,12 @@ npm run memory -- handoff --workspace /absolute/path/to/your-project --launch
|
|
|
177
167
|
The handoff command opens a terminal picker. `--preview` reports the selected handoff without importing or configuring it; `--launch` imports it, configures Codex, and launches Codex in the destination workspace. You can pass `--conversation TITLE_OR_ID` for an explicit selection.
|
|
178
168
|
|
|
179
169
|
This is a separate source-development workflow: it defaults to the checkout's `.memory/events.sqlite`, whereas npm setup uses the persistent installation's data directory. Set `MEMORY_DB` to the intended database if deliberately sharing them. Handoff applies connector settings and may report a conflict with an already managed connection; review that configuration before switching workflows.
|
|
170
|
+
|
|
171
|
+
## Private cloud history and sharing
|
|
172
|
+
|
|
173
|
+
After installation, ask the agent **Set up Knitt for this project**. It checks account and sync status, opens browser pairing when needed, and offers personal work or a friend's invitation. For personal history, review discovered conversations, explicitly choose or create the cloud project, and approve automatic private sync. Nothing uploads from sign-in alone.
|
|
174
|
+
|
|
175
|
+
The running adapter and supported capture hooks import approved project histories independently of continuation selection. Offline uploads queue for retry. `/knit` offers My synced conversations, Local conversations and Shared with me after pairing. Choose explicitly; a later sync or publication does not replace the version already loaded in your current session.
|
|
176
|
+
|
|
177
|
+
Only an explicitly reviewed publication and accepted invitation grants another person access. Private synced history stays private. Settings at https://knit.deeeznuts.me exposes project pause/disconnect and installation revocation. Copies already retrieved can remain in an agent's chat or storage after revocation.
|
|
178
|
+
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tinchu0/knitt",
|
|
3
|
-
"version": "0.1.0-beta.
|
|
3
|
+
"version": "0.1.0-beta.6",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"engines": {
|
|
6
6
|
"node": ">=24"
|
|
@@ -32,7 +32,10 @@
|
|
|
32
32
|
"knitt": "dist/packages/installer/src/cli.js"
|
|
33
33
|
},
|
|
34
34
|
"files": [
|
|
35
|
-
"dist/",
|
|
35
|
+
"dist/apps/server/",
|
|
36
|
+
"dist/packages/",
|
|
37
|
+
"dist/scripts/connector-setup.js",
|
|
38
|
+
"dist/skills/",
|
|
36
39
|
"README.md",
|
|
37
40
|
"docs/usage.md",
|
|
38
41
|
"docs/clients/support-matrix.md",
|
|
@@ -47,7 +50,7 @@
|
|
|
47
50
|
"description": "Shared conversation memory for coding agents",
|
|
48
51
|
"publishConfig": {
|
|
49
52
|
"access": "public",
|
|
50
|
-
"tag": "
|
|
53
|
+
"tag": "latest"
|
|
51
54
|
},
|
|
52
55
|
"license": "Apache-2.0"
|
|
53
56
|
}
|