granola-toolkit 0.25.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 +43 -1
  2. package/dist/cli.js +2283 -1378
  3. package/package.json +3 -1
package/README.md CHANGED
@@ -32,11 +32,13 @@ 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
38
39
  granola notes --help
39
40
  granola serve --help
41
+ granola tui --help
40
42
  granola transcripts --help
41
43
  granola web --help
42
44
  ```
@@ -48,10 +50,12 @@ Local build:
48
50
  ```bash
49
51
  vp pack
50
52
  node dist/cli.js --help
53
+ node dist/cli.js attach --help
51
54
  node dist/cli.js exports --help
52
55
  node dist/cli.js meeting --help
53
56
  node dist/cli.js notes --help
54
57
  node dist/cli.js serve --help
58
+ node dist/cli.js tui --help
55
59
  node dist/cli.js transcripts --help
56
60
  node dist/cli.js web --help
57
61
  ```
@@ -62,6 +66,7 @@ You can also use the package scripts:
62
66
  npm run build
63
67
  npm run start -- meeting --help
64
68
  npm run notes -- --help
69
+ npm run tui -- --help
65
70
  npm run transcripts -- --help
66
71
  ```
67
72
 
@@ -95,6 +100,8 @@ granola meeting view 1234abcd
95
100
  granola meeting notes 1234abcd
96
101
  granola meeting transcript 1234abcd --format json
97
102
  granola meeting export 1234abcd --format yaml
103
+ granola tui
104
+ granola tui --meeting 1234abcd
98
105
  ```
99
106
 
100
107
  Run the local API server:
@@ -104,6 +111,9 @@ granola serve
104
111
  granola serve --port 4096
105
112
  granola serve --hostname 0.0.0.0 --port 4096
106
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"
107
117
 
108
118
  granola web
109
119
  granola web --open=false --port 4096
@@ -213,7 +223,7 @@ The initial server API includes:
213
223
  - `POST /exports/jobs/:id/rerun`
214
224
  - `POST /exports/transcripts`
215
225
 
216
- 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`.
217
227
 
218
228
  Server hardening now includes:
219
229
 
@@ -242,6 +252,38 @@ The initial browser client includes:
242
252
  - stronger empty and error states for list/detail failures
243
253
  - a server-access panel that can unlock or lock a password-protected local server
244
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
+
267
+ ### TUI
268
+
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.
270
+
271
+ The initial terminal workspace includes:
272
+
273
+ - a meeting list pane with keyboard navigation
274
+ - a detail pane with notes, transcript, metadata, and raw views
275
+ - a footer with app state and key hints
276
+ - a quick-open overlay for jumping by title, id, or tag
277
+
278
+ The main keyboard controls are:
279
+
280
+ - `j` / `k` or arrow keys to move between meetings
281
+ - `/` or `Ctrl+P` to open quick open
282
+ - `1`-`4` to switch detail tabs
283
+ - `PageUp` / `PageDown` to scroll the detail pane
284
+ - `r` to refresh from live Granola data
285
+ - `q` to quit
286
+
245
287
  ### Local Meeting Index
246
288
 
247
289
  Interactive meeting browsing now keeps a local index of meeting summaries and metadata.