@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.
Files changed (33) hide show
  1. package/README.md +24 -15
  2. package/dist/apps/server/src/cloud-picker.js +245 -0
  3. package/dist/apps/server/src/http-gateway.js +1 -1
  4. package/dist/apps/server/src/main.js +6 -2
  5. package/dist/apps/server/src/onboarding.js +266 -0
  6. package/dist/apps/server/src/plugin-bootstrap.js +82 -0
  7. package/dist/apps/server/src/plugin-hook.js +51 -0
  8. package/dist/apps/server/src/plugin-main.js +10 -0
  9. package/dist/apps/server/src/server.js +108 -29
  10. package/dist/packages/adapters/src/cli.js +19 -2
  11. package/dist/packages/adapters/src/handoff.js +10 -6
  12. package/dist/packages/adapters/src/histories.js +221 -0
  13. package/dist/packages/adapters/src/history-time.js +10 -0
  14. package/dist/packages/adapters/src/hooks.js +8 -8
  15. package/dist/packages/adapters/src/picker.js +2 -1
  16. package/dist/packages/adapters/src/question-ui.js +37 -0
  17. package/dist/packages/adapters/src/scope.js +9 -3
  18. package/dist/packages/adapters/src/server-name.js +5 -0
  19. package/dist/packages/adapters/src/transcript.js +2 -0
  20. package/dist/packages/cloud/src/client.js +40 -0
  21. package/dist/packages/cloud/src/local-sync.js +300 -0
  22. package/dist/packages/installer/src/antigravity.js +90 -0
  23. package/dist/packages/installer/src/cli.js +77 -30
  24. package/dist/packages/installer/src/cloud-cli.js +199 -0
  25. package/dist/packages/installer/src/connections.js +37 -9
  26. package/dist/packages/installer/src/runtime.js +2 -2
  27. package/dist/packages/memory/src/store.js +36 -0
  28. package/dist/skills/knit/SKILL.md +27 -5
  29. package/docs/clients/connector-setup.md +1 -1
  30. package/docs/clients/npm-installation.md +28 -12
  31. package/docs/clients/support-matrix.md +12 -0
  32. package/docs/usage.md +28 -29
  33. 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. Build the installation package
19
+ ## 2. Run the package
20
20
 
21
- The repository currently documents Knitt as an unpublished release candidate. Use a locally built tarball for this guide; registry installation is not assumed.
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
- KNITT_TARBALL="/absolute/path/to/knitt/tinchu0-knitt-0.1.0-beta.1.tgz"
24
+ npx @tinchu0/knitt@latest --version
36
25
  ```
37
26
 
38
- Replace the example path with the location printed by `npm pack`. If the package version changes, use the new filename. Keep the tarball available for later management commands.
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 --yes --package "$KNITT_TARBALL" knitt setup \
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 --yes --package "$KNITT_TARBALL" knitt setup \
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
- The two package arguments have different jobs: npx's `--package` runs the CLI, while setup's `--package` installs that exact artifact as a persistent runtime. Connected agents then use the persistent runtime independently of npx's temporary cache.
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 in the picker. Knitt's current picker discovers local **Antigravity conversations** belonging to the connected repository, including linked worktrees. It does not browse arbitrary Claude or ChatGPT account history.
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 conversation selection, supported coding hooks capture available user and assistant text when the client runs them. Capture depends on client support and hook trust; an installed configuration alone does not prove capture is working.
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 tarball CLI and, if configured, the same `--home /absolute/path` for all commands.
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 --yes --package "$KNITT_TARBALL" knitt doctor
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 --yes --package "$KNITT_TARBALL" knitt rollback --yes
131
+ npx @tinchu0/knitt@latest rollback --yes
142
132
  ```
143
133
 
144
134
  Disconnect one project:
145
135
 
146
136
  ```bash
147
- npx --yes --package "$KNITT_TARBALL" knitt uninstall \
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 the source chat is a local Antigravity conversation associated with this repository or its worktrees. Try searching its title. Other account histories are not imported. |
159
- | Client cannot show a selection form | For local Antigravity-to-Codex handoff, use the source-checkout fallback below. Remote HTTP clients may receive a browser picker link instead. |
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 that selection happened before capture, hooks were trusted and executed, or an explicit `save_memory` call succeeded. |
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.4",
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": "next"
53
+ "tag": "latest"
51
54
  },
52
55
  "license": "Apache-2.0"
53
56
  }