granola-toolkit 0.26.0 → 0.27.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.
Files changed (3) hide show
  1. package/README.md +19 -2
  2. package/dist/cli.js +5099 -4839
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -32,6 +32,7 @@ Installed command:
32
32
 
33
33
  ```bash
34
34
  granola --help
35
+ granola attach --help
35
36
  granola auth login
36
37
  granola exports --help
37
38
  granola meeting --help
@@ -49,6 +50,7 @@ Local build:
49
50
  ```bash
50
51
  vp pack
51
52
  node dist/cli.js --help
53
+ node dist/cli.js attach --help
52
54
  node dist/cli.js exports --help
53
55
  node dist/cli.js meeting --help
54
56
  node dist/cli.js notes --help
@@ -109,6 +111,9 @@ granola serve
109
111
  granola serve --port 4096
110
112
  granola serve --hostname 0.0.0.0 --port 4096
111
113
  granola serve --network lan --password "change-me"
114
+ granola attach http://127.0.0.1:4096
115
+ granola attach http://127.0.0.1:4096 --meeting 1234abcd
116
+ granola attach http://127.0.0.1:4096 --password "change-me"
112
117
 
113
118
  granola web
114
119
  granola web --open=false --port 4096
@@ -218,7 +223,7 @@ The initial server API includes:
218
223
  - `POST /exports/jobs/:id/rerun`
219
224
  - `POST /exports/transcripts`
220
225
 
221
- This is the foundation for the future `granola web` client and any attachable TUI flows.
226
+ This is the shared runtime for `granola web` and `granola attach`.
222
227
 
223
228
  Server hardening now includes:
224
229
 
@@ -247,9 +252,21 @@ The initial browser client includes:
247
252
  - stronger empty and error states for list/detail failures
248
253
  - a server-access panel that can unlock or lock a password-protected local server
249
254
 
255
+ ### Attach
256
+
257
+ `attach` connects the terminal workspace to an already running `granola serve` or `granola web` instance instead of starting a second isolated app.
258
+
259
+ Use it when you want:
260
+
261
+ - two terminal workspaces attached to the same live app state
262
+ - one terminal workspace and one browser workspace sharing auth, meeting index, and export-job history
263
+ - a password-protected local server to remain the single source of truth
264
+
265
+ The attach flow uses the existing local HTTP API plus `GET /events` for live state updates.
266
+
250
267
  ### TUI
251
268
 
252
- `tui` starts a full-screen terminal workspace on the shared app core, without requiring the local server or browser client.
269
+ `tui` starts a full-screen terminal workspace on the shared app core, without requiring the local server or browser client. Use `attach` when you want the same workspace against an existing shared server instance instead.
253
270
 
254
271
  The initial terminal workspace includes:
255
272