livepilot 1.7.3 → 1.7.4

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 (2) hide show
  1. package/README.md +328 -84
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -8,53 +8,75 @@
8
8
  ```
9
9
 
10
10
  An agentic production system for Ableton Live 12.
11
+
11
12
  155 tools. Device atlas. Spectral perception. Technique memory.
12
13
  Neo-Riemannian harmony. Euclidean rhythm. Species counterpoint.
14
+
13
15
  It doesn't assist — it produces.
14
16
 
15
- ---
17
+ <br>
18
+
19
+ ───────────────────────────────────────────────────────────────
16
20
 
17
21
  ## Architecture
18
22
 
19
23
  ```
20
- ┌─────────────────────────────────────────────────────────┐
21
-
22
- │ KNOWLEDGE PERCEPTION MEMORY │
23
- │ ─────────── ────────── ────── │
24
- 280+ devices 8-band FFT recall by
25
- 139 drum kits RMS / peak mood, genre,
26
- 350+ impulse pitch tracking texture
27
- responses key detection
28
-
29
- ┌────────────┐ ┌────────────┐ ┌────────────┐
30
- Device │───▶│ M4L │───▶│ Technique
31
- │ │ Atlas │ │ Analyzer Store
32
- └─────┬──────┘ └─────┬──────┘ └─────┬──────┘
33
- └─────────────────┼─────────────────┘
34
-
35
- ┌─────────────────┐
36
- │ 155 MCP Tools │
37
- 16 domains
38
- └────────┬────────┘
39
-
40
- Remote Script ──┤── TCP 9878
41
- M4L Bridge ─────┤── UDP 9880 / OSC 9881
42
-
43
- ┌────────────────┐
44
- Ableton Live │ │
45
- └────────────────┘
46
- └─────────────────────────────────────────────────────────┘
47
- ```
48
-
49
- The atlas gives the AI knowledge of every device in Ableton's library — real names, real URIs, real parameters. The analyzer gives it ears — spectral data from the master bus via a Max for Live device. The memory gives it history — a searchable library of production decisions that persists across sessions. All three feed into 155 deterministic tools that execute on Ableton's main thread through the official Live Object Model API. Everything is reversible with undo.
50
-
51
- ---
24
+ ┌─────────────────────────────────────────────────────────────┐
25
+
26
+ │ KNOWLEDGE PERCEPTION MEMORY │
27
+ │ ─────────── ────────── ────── │
28
+
29
+ 280+ devices 8-band FFT recall by
30
+ 139 drum kits RMS / peak mood, genre,
31
+ 350+ impulse pitch tracking texture
32
+ responses key detection
33
+
34
+ ┌────────────┐ ┌────────────┐ ┌────────────┐
35
+ │ │ Device │─────▶│ M4L │─────▶│ Technique │ │
36
+ │ Atlas │ │ Analyzer │ │ Store
37
+ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘
38
+ └───────────────────┼───────────────────┘
39
+
40
+ ┌─────────────────┐
41
+ 155 MCP Tools
42
+ │ │ 16 domains │ │
43
+ └────────┬────────┘
44
+
45
+ Remote Script ──┤── TCP 9878
46
+ M4L Bridge ─────┤── UDP 9880 / OSC 9881
47
+
48
+ ┌────────────────┐
49
+ Ableton Live │ │
50
+ │ └────────────────┘ │
51
+ └─────────────────────────────────────────────────────────────┘
52
+ ```
53
+
54
+ The atlas gives the AI knowledge of every device in Ableton's library —
55
+ real names, real URIs, real parameters.
56
+
57
+ The analyzer gives it ears — spectral data from the master bus
58
+ via a Max for Live device.
59
+
60
+ The memory gives it history — a searchable library of production decisions
61
+ that persists across sessions.
62
+
63
+ All three feed into 155 deterministic tools that execute on Ableton's main thread
64
+ through the official Live Object Model API. Everything is reversible with undo.
65
+
66
+ <br>
67
+
68
+ ───────────────────────────────────────────────────────────────
52
69
 
53
70
  ## Tools
54
71
 
55
- ### CORE ─────────────────────────────────────────
72
+ <br>
73
+
74
+ ### CORE ──────────────────────────────────────────────────────
56
75
 
57
- The foundation. Session control, MIDI, device management, mixing. Every tool maps directly to an LOM call — no abstraction, no guessing.
76
+ The foundation. Session control, MIDI, device management, mixing.
77
+ Every tool maps directly to an LOM call — no abstraction, no guessing.
78
+
79
+ <br>
58
80
 
59
81
  | Domain | # | Scope |
60
82
  |--------|:-:|-------|
@@ -67,84 +89,221 @@ The foundation. Session control, MIDI, device management, mixing. Every tool map
67
89
  | Browser | 4 | search library, browse tree, load items, filter by category |
68
90
  | Mixing | 11 | volume, pan, sends, routing, meters, return tracks, master, full mix snapshot |
69
91
 
70
- ### PERCEPTION ───────────────────────────────────
92
+ <br>
93
+
94
+ ### PERCEPTION ────────────────────────────────────────────────
95
+
96
+ The M4L Analyzer sits on the master track. UDP 9880 carries spectral data
97
+ from Max to the server. OSC 9881 sends commands back.
71
98
 
72
- The M4L Analyzer sits on the master track. UDP 9880 carries spectral data from Max to the server. OSC 9881 sends commands back. All 135 core tools work without it — the analyzer adds 20 more and closes the feedback loop.
99
+ All 135 core tools work without it — the analyzer adds 20 more
100
+ and closes the feedback loop.
73
101
 
74
- **Spectral Analysis (3)** — 8-band frequency decomposition (sub → air), true RMS/peak metering, Krumhansl-Schmuckler key detection on accumulated pitch data.
102
+ <br>
75
103
 
76
- **Deep LOM Access (4)** — hidden parameters not in the ControlSurface API, automation state for every parameter, recursive device tree walking (6 levels into nested racks), human-readable display values as shown in Live's UI.
104
+ ```
105
+ SPECTRAL ─────── 8-band frequency decomposition (sub → air)
106
+ true RMS / peak metering
107
+ Krumhansl-Schmuckler key detection
108
+
109
+ DEEP LOM ─────── hidden parameters beyond ControlSurface API
110
+ automation state per parameter
111
+ recursive device tree (6 levels into nested racks)
112
+ human-readable display values as shown in Live's UI
113
+
114
+ SIMPLER ──────── replace / load samples
115
+ get slice points, crop, reverse
116
+ warp to N beats, get audio file paths
117
+
118
+ WARP ─────────── get / add / move / remove markers
119
+ tempo manipulation at the sample level
120
+
121
+ PREVIEW ──────── scrub at beat position
122
+ stop scrub
123
+ ```
124
+
125
+ <br>
77
126
 
78
- **Simpler Operations (7)** — replace/load samples, get slice points, crop, reverse, warp to N beats, get audio file paths on disk.
127
+ ### INTELLIGENCE ──────────────────────────────────────────────
79
128
 
80
- **Warp Markers (4)** — get/add/move/remove. Tempo manipulation at the sample level.
129
+ <br>
81
130
 
82
- **Clip Preview (2)** scrub at beat position, stop scrub.
131
+ #### Theory ─── 7 tools
83
132
 
84
- ### INTELLIGENCE ─────────────────────────────────
133
+ Krumhansl-Schmuckler key detection with 7 mode profiles:
134
+ major, minor, dorian, phrygian, lydian, mixolydian, locrian.
85
135
 
86
- #### Theory 7 tools
136
+ Roman numeral analysis via scale-degree chord matching
137
+ on a 1/32 note quantization grid.
87
138
 
88
- Krumhansl-Schmuckler key detection with 7 mode profiles (major, minor, dorian, phrygian, lydian, mixolydian, locrian). Roman numeral analysis via scale-degree chord matching on a 1/32 note quantization grid. Voice leading checks — parallel fifths, parallel octaves, voice crossing, unresolved dominants. Species counterpoint generation (1st and 2nd species). SATB harmonization with smooth voice leading. Diatonic transposition that preserves scale relationships.
139
+ Voice leading checks — parallel fifths, parallel octaves,
140
+ voice crossing, unresolved dominants.
89
141
 
90
- `analyze_harmony` · `suggest_next_chord` · `detect_theory_issues` · `identify_scale` · `harmonize_melody` · `generate_countermelody` · `transpose_smart`
142
+ Species counterpoint generation (1st and 2nd species).
143
+ SATB harmonization with smooth voice leading.
144
+ Diatonic transposition that preserves scale relationships.
91
145
 
92
- #### Harmony — 4 tools
146
+ ```
147
+ analyze_harmony suggest_next_chord detect_theory_issues
148
+ identify_scale harmonize_melody generate_countermelody
149
+ transpose_smart
150
+ ```
93
151
 
94
- Neo-Riemannian PRL transforms on the Tonnetz. P flips the third: Cm ↔ C. L shifts by semitone: C ↔ Em. R by whole tone: C ↔ Am. All three are involutions — apply twice, return to origin. BFS through PRL space finds the shortest voice-leading path between any two triads. Cm to E major? That's PLP — the hexatonic pole. Three steps, each moving one voice by a semitone. The Hitchcock chord change.
152
+ <br>
95
153
 
96
- Chromatic mediants for film-score harmony: chords a major/minor third away sharing 0-1 common tones. Maximum color shift, minimal voice movement.
154
+ #### Harmony ─── 4 tools
97
155
 
98
- `navigate_tonnetz` · `find_voice_leading_path` · `classify_progression` · `suggest_chromatic_mediants`
156
+ Neo-Riemannian PRL transforms on the Tonnetz.
99
157
 
100
- #### Generative — 5 tools
158
+ ```
159
+ P flips the third ─────── Cm ↔ C
160
+ L shifts by semitone ──── C ↔ Em
161
+ R shifts by whole tone ── C ↔ Am
162
+ ```
101
163
 
102
- Bjorklund distributes N pulses across M steps Bresenham's line algorithm applied to rhythm. E(3,8) = tresillo. E(5,8) = cinquillo. E(7,16) = Brazilian necklace. Layer multiple Euclidean patterns at different pitches for polyrhythmic textures.
164
+ All three are involutionsapply twice, return to origin.
103
165
 
104
- Tintinnabuli (Arvo Pärt): for each melody note, find the nearest tone of a specified triad — above, below, or nearest. The T-voice gravitates toward the triad while the M-voice moves stepwise. Two voices, one rule, infinite music.
166
+ BFS through PRL space finds the shortest voice-leading path
167
+ between any two triads. Cm to E major? That's PLP — the hexatonic pole.
168
+ Three steps, each moving one voice by a semitone.
169
+ The Hitchcock chord change.
105
170
 
106
- Phase shifting (Steve Reich): identical voices with accumulating timing drift. Voice 0 plays straight. Each subsequent voice shifts by N beats per repetition. They start in unison, gradually separate, and eventually realign.
171
+ Chromatic mediants for film-score harmony: chords a major/minor third away
172
+ sharing 0-1 common tones. Maximum color shift, minimal voice movement.
173
+
174
+ ```
175
+ navigate_tonnetz find_voice_leading_path
176
+ classify_progression suggest_chromatic_mediants
177
+ ```
107
178
 
108
- Additive process (Philip Glass): melody unfolds note by note. Forward: 1, then 1-2, then 1-2-3. Backward: full melody, then remove from front. Both: forward then backward. The structure *is* the composition.
179
+ <br>
109
180
 
110
- `generate_euclidean_rhythm` · `layer_euclidean_rhythms` · `generate_tintinnabuli` · `generate_phase_shift` · `generate_additive_process`
181
+ #### Generative ─── 5 tools
111
182
 
112
- #### Automation8 tools
183
+ **Euclidean Rhythm**Bjorklund distributes N pulses across M steps.
184
+ Bresenham's line algorithm applied to rhythm.
185
+
186
+ ```
187
+ E(3,8) = tresillo ×··×··×·
188
+ E(5,8) = cinquillo ×·××·××·
189
+ E(7,16) = Brazilian necklace ×·×·×××·×·×·×××·
190
+ ```
191
+
192
+ Layer multiple patterns at different pitches for polyrhythmic textures.
193
+
194
+ **Tintinnabuli** (Arvo Pärt) — for each melody note, find the nearest tone
195
+ of a specified triad: above, below, or nearest. The T-voice gravitates toward
196
+ the triad while the M-voice moves stepwise. Two voices, one rule, infinite music.
197
+
198
+ **Phase Shifting** (Steve Reich) — identical voices with accumulating timing drift.
199
+ Voice 0 plays straight. Each subsequent voice shifts by N beats per repetition.
200
+ They start in unison, gradually separate, and eventually realign.
201
+
202
+ **Additive Process** (Philip Glass) — melody unfolds note by note.
203
+ Forward: 1, then 1-2, then 1-2-3.
204
+ Backward: full melody, then remove from front.
205
+ Both: forward then backward.
206
+ The structure *is* the composition.
207
+
208
+ ```
209
+ generate_euclidean_rhythm layer_euclidean_rhythms
210
+ generate_tintinnabuli generate_phase_shift
211
+ generate_additive_process
212
+ ```
213
+
214
+ <br>
215
+
216
+ #### Automation ─── 8 tools
113
217
 
114
218
  16 curve types in 4 categories:
115
219
 
116
220
  ```
117
- BASIC ─────── linear · exponential · logarithmic · s_curve
118
- sine · sawtooth · spike · square · steps
119
- ORGANIC ───── perlin · brownian · spring
120
- SHAPE ─────── bezier · easing (8 types: bounce, elastic, back...)
121
- GENERATIVE ── euclidean · stochastic
221
+ BASIC ──────────── linear · exponential · logarithmic · s_curve
222
+ sine · sawtooth · spike · square · steps
223
+
224
+ ORGANIC ─────────── perlin · brownian · spring
225
+
226
+ SHAPE ──────────── bezier · easing
227
+ (bounce, elastic, back, quad, cubic,
228
+ quart, quint, expo)
229
+
230
+ GENERATIVE ─────── euclidean · stochastic
122
231
  ```
123
232
 
124
- 15 built-in recipes: `filter_sweep_up` · `filter_sweep_down` · `dub_throw` · `tape_stop` · `build_rise` · `sidechain_pump` · `fade_in` · `fade_out` · `tremolo` · `auto_pan` · `stutter` · `breathing` · `washout` · `vinyl_crackle` · `stereo_narrow`
233
+ 15 built-in recipes:
234
+
235
+ ```
236
+ filter_sweep_up filter_sweep_down dub_throw
237
+ tape_stop build_rise sidechain_pump
238
+ fade_in fade_out tremolo
239
+ auto_pan stutter breathing
240
+ washout vinyl_crackle stereo_narrow
241
+ ```
125
242
 
126
- Perception-action loop: `analyze_for_automation` reads the spectrum and device chain, suggests what to automate, and maps each suggestion to a recipe. The AI doesn't write automation blind — it knows what to automate based on what it hears.
243
+ Perception-action loop: `analyze_for_automation` reads the spectrum
244
+ and device chain, suggests what to automate, and maps each suggestion
245
+ to a recipe. The AI doesn't write automation blind — it knows what
246
+ to automate based on what it hears.
247
+
248
+ ```
249
+ get_clip_automation set_clip_automation clear_clip_automation
250
+ apply_automation_shape apply_automation_recipe get_automation_recipes
251
+ generate_automation_curve analyze_for_automation
252
+ ```
127
253
 
128
- `get_clip_automation` · `set_clip_automation` · `clear_clip_automation` · `apply_automation_shape` · `apply_automation_recipe` · `get_automation_recipes` · `generate_automation_curve` · `analyze_for_automation`
254
+ <br>
129
255
 
130
- ### MEMORY + I/O ──────────────────────────────────
256
+ ### MEMORY + I/O ──────────────────────────────────────────────
131
257
 
132
- #### Memory — 8 tools
258
+ <br>
133
259
 
134
- Persistent technique library. Five types: `beat_pattern`, `device_chain`, `mix_template`, `preference`, `browser_pin`. Each stores identity (name, tags, timestamps), qualities (mood, genre, texture, production notes), and payload (raw MIDI, device params, tempo, URIs). Recall by text query matching mood, genre, texture — not just names. Favorite, rate, replay.
260
+ #### Memory ─── 8 tools
135
261
 
136
- `memory_learn` · `memory_recall` · `memory_list` · `memory_get` · `memory_update` · `memory_delete` · `memory_favorite` · `memory_replay`
262
+ Persistent technique library across sessions.
263
+
264
+ Five types: `beat_pattern` · `device_chain` · `mix_template` · `preference` · `browser_pin`
265
+
266
+ Each stores:
267
+ - **Identity** — name, tags, timestamps
268
+ - **Qualities** — mood, genre, texture, production notes
269
+ - **Payload** — raw MIDI, device params, tempo, URIs
270
+
271
+ Recall by text query matching mood, genre, texture — not just names.
272
+ Favorite, rate, replay.
273
+
274
+ ```
275
+ memory_learn memory_recall memory_list memory_get
276
+ memory_update memory_delete memory_favorite memory_replay
277
+ ```
137
278
 
138
- #### MIDI I/O — 4 tools
279
+ <br>
139
280
 
140
- Export session clips to standard .mid files. Import .mid into session clips — auto-creates the clip, tempo-aware timing conversion. Offline analysis without Ableton: note count, duration, tempo, pitch range, velocity stats, density curve, key estimate. Piano roll extraction: 2D velocity matrix at configurable resolution (default 1/32 note). Dependencies lazy-loaded — graceful error if missing.
281
+ #### MIDI I/O ─── 4 tools
141
282
 
142
- `export_clip_midi` · `import_midi_to_clip` · `analyze_midi_file` · `extract_piano_roll`
283
+ Export session clips to standard .mid files.
284
+ Import .mid into session clips — auto-creates the clip, tempo-aware timing.
143
285
 
144
- ---
286
+ Offline analysis without Ableton: note count, duration, tempo,
287
+ pitch range, velocity stats, density curve, key estimate.
288
+
289
+ Piano roll extraction: 2D velocity matrix at configurable resolution
290
+ (default 1/32 note).
291
+
292
+ Dependencies lazy-loaded — graceful error if missing.
293
+
294
+ ```
295
+ export_clip_midi import_midi_to_clip
296
+ analyze_midi_file extract_piano_roll
297
+ ```
298
+
299
+ <br>
300
+
301
+ ───────────────────────────────────────────────────────────────
145
302
 
146
303
  ## Install
147
304
 
305
+ <br>
306
+
148
307
  ### 1. Remote Script
149
308
 
150
309
  ```bash
@@ -153,6 +312,8 @@ npx livepilot --install
153
312
 
154
313
  Restart Ableton → Preferences → Link, Tempo & MIDI → Control Surface → **LivePilot**
155
314
 
315
+ <br>
316
+
156
317
  ### 2. MCP Client
157
318
 
158
319
  <details open>
@@ -259,9 +420,18 @@ Windsurf — `~/.codeium/windsurf/mcp_config.json`:
259
420
 
260
421
  </details>
261
422
 
423
+ <br>
424
+
262
425
  ### 3. M4L Analyzer (optional)
263
426
 
264
- Drag `LivePilot_Analyzer.amxd` onto the master track. Unlocks 20 additional tools: spectral analysis, key detection, sample manipulation, deep device introspection. All core tools work without it.
427
+ Drag `LivePilot_Analyzer.amxd` onto the master track.
428
+
429
+ Unlocks 20 additional tools: spectral analysis, key detection,
430
+ sample manipulation, deep device introspection.
431
+
432
+ All core tools work without it.
433
+
434
+ <br>
265
435
 
266
436
  ### 4. Verify
267
437
 
@@ -269,7 +439,9 @@ Drag `LivePilot_Analyzer.amxd` onto the master track. Unlocks 20 additional tool
269
439
  npx livepilot --status
270
440
  ```
271
441
 
272
- ---
442
+ <br>
443
+
444
+ ───────────────────────────────────────────────────────────────
273
445
 
274
446
  ## Plugin
275
447
 
@@ -277,6 +449,8 @@ npx livepilot --status
277
449
  claude plugin add github:dreamrec/LivePilot/plugin
278
450
  ```
279
451
 
452
+ <br>
453
+
280
454
  | Command | What |
281
455
  |---------|------|
282
456
  | `/session` | Full session overview with diagnostics |
@@ -285,17 +459,30 @@ claude plugin add github:dreamrec/LivePilot/plugin
285
459
  | `/sounddesign` | Sound design workflow |
286
460
  | `/memory` | Technique library management |
287
461
 
288
- **Producer Agent** — autonomous multi-step production. Consults memory for style context, searches the atlas for instruments, creates tracks, programs MIDI, chains effects, reads the spectrum to verify. Ships with a reference corpus (drum patterns, chord voicings, sound design recipes, mixing templates).
462
+ <br>
463
+
464
+ **Producer Agent** — autonomous multi-step production.
465
+ Consults memory for style context, searches the atlas for instruments,
466
+ creates tracks, programs MIDI, chains effects, reads the spectrum to verify.
467
+ Ships with a reference corpus (drum patterns, chord voicings,
468
+ sound design recipes, mixing templates).
289
469
 
290
- **Core Skill** — operational discipline connecting all three layers. Consult atlas before loading. Read analyzer after mixing. Check memory before creative decisions. Verify every mutation.
470
+ **Core Skill** — operational discipline connecting all three layers.
471
+ Consult atlas before loading. Read analyzer after mixing.
472
+ Check memory before creative decisions. Verify every mutation.
291
473
 
292
- ---
474
+ <br>
293
475
 
294
- ## Full Tool List ────────────────────────────────
476
+ ───────────────────────────────────────────────────────────────
477
+
478
+ ## Full Tool List
295
479
 
296
480
  155 tools across 16 domains.
297
481
 
482
+ <br>
483
+
298
484
  ### Transport (12)
485
+
299
486
  | Tool | Description |
300
487
  |------|-------------|
301
488
  | `get_session_info` | Session state: tempo, tracks, scenes, transport |
@@ -311,7 +498,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
311
498
  | `get_recent_actions` | Recent undo history |
312
499
  | `get_session_diagnostics` | Analyze session for issues |
313
500
 
501
+ <br>
502
+
314
503
  ### Tracks (14)
504
+
315
505
  | Tool | Description |
316
506
  |------|-------------|
317
507
  | `get_track_info` | Track details: clips, devices, mixer |
@@ -329,7 +519,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
329
519
  | `set_group_fold` | Fold/unfold group track |
330
520
  | `set_track_input_monitoring` | Set monitoring mode |
331
521
 
522
+ <br>
523
+
332
524
  ### Clips (11)
525
+
333
526
  | Tool | Description |
334
527
  |------|-------------|
335
528
  | `get_clip_info` | Clip details: length, loop, launch |
@@ -344,7 +537,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
344
537
  | `set_clip_launch` | Launch mode and quantization |
345
538
  | `set_clip_warp_mode` | Set warp algorithm |
346
539
 
540
+ <br>
541
+
347
542
  ### Notes (8)
543
+
348
544
  | Tool | Description |
349
545
  |------|-------------|
350
546
  | `add_notes` | Add MIDI notes with velocity, probability |
@@ -356,7 +552,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
356
552
  | `transpose_notes` | Shift pitch by semitones |
357
553
  | `quantize_clip` | Quantize to grid |
358
554
 
555
+ <br>
556
+
359
557
  ### Devices (12)
558
+
360
559
  | Tool | Description |
361
560
  |------|-------------|
362
561
  | `get_device_info` | Device name, class, parameters |
@@ -372,7 +571,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
372
571
  | `set_chain_volume` | Set chain volume in rack |
373
572
  | `get_device_presets` | List available presets |
374
573
 
574
+ <br>
575
+
375
576
  ### Scenes (8)
577
+
376
578
  | Tool | Description |
377
579
  |------|-------------|
378
580
  | `get_scenes_info` | All scenes: name, tempo, color |
@@ -384,7 +586,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
384
586
  | `set_scene_color` | Set color |
385
587
  | `set_scene_tempo` | Per-scene tempo |
386
588
 
589
+ <br>
590
+
387
591
  ### Mixing (11)
592
+
388
593
  | Tool | Description |
389
594
  |------|-------------|
390
595
  | `set_track_volume` | Volume (0.0-1.0) |
@@ -399,7 +604,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
399
604
  | `get_master_meters` | Master meter levels |
400
605
  | `get_mix_snapshot` | Full mix state in one call |
401
606
 
607
+ <br>
608
+
402
609
  ### Browser (4)
610
+
403
611
  | Tool | Description |
404
612
  |------|-------------|
405
613
  | `get_browser_tree` | Browse category tree |
@@ -407,7 +615,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
407
615
  | `search_browser` | Search by name with filters |
408
616
  | `load_browser_item` | Load item by URI |
409
617
 
618
+ <br>
619
+
410
620
  ### Arrangement (19)
621
+
411
622
  | Tool | Description |
412
623
  |------|-------------|
413
624
  | `get_arrangement_clips` | List arrangement clips |
@@ -430,7 +641,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
430
641
  | `jump_to_cue` | Jump to cue point |
431
642
  | `toggle_cue_point` | Add/remove cue point |
432
643
 
644
+ <br>
645
+
433
646
  ### Automation (8)
647
+
434
648
  | Tool | Description |
435
649
  |------|-------------|
436
650
  | `get_clip_automation` | List envelopes on a clip |
@@ -442,7 +656,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
442
656
  | `generate_automation_curve` | Preview curve without writing |
443
657
  | `analyze_for_automation` | Spectral analysis + suggestions |
444
658
 
659
+ <br>
660
+
445
661
  ### Memory (8)
662
+
446
663
  | Tool | Description |
447
664
  |------|-------------|
448
665
  | `memory_learn` | Save a technique |
@@ -454,7 +671,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
454
671
  | `memory_favorite` | Toggle favorite |
455
672
  | `memory_replay` | Replay saved technique |
456
673
 
674
+ <br>
675
+
457
676
  ### Analyzer (20) `[M4L]`
677
+
458
678
  | Tool | Description |
459
679
  |------|-------------|
460
680
  | `get_master_spectrum` | 8-band frequency analysis |
@@ -478,7 +698,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
478
698
  | `scrub_clip` | Preview at beat position |
479
699
  | `stop_scrub` | Stop preview |
480
700
 
701
+ <br>
702
+
481
703
  ### Theory (7)
704
+
482
705
  | Tool | Description |
483
706
  |------|-------------|
484
707
  | `analyze_harmony` | Chord-by-chord Roman numeral analysis |
@@ -489,7 +712,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
489
712
  | `generate_countermelody` | Species counterpoint (1st/2nd) |
490
713
  | `transpose_smart` | Diatonic or chromatic transposition |
491
714
 
715
+ <br>
716
+
492
717
  ### Generative (5)
718
+
493
719
  | Tool | Description |
494
720
  |------|-------------|
495
721
  | `generate_euclidean_rhythm` | Bjorklund algorithm, identifies named rhythms |
@@ -498,7 +724,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
498
724
  | `generate_phase_shift` | Steve Reich — drifting canon |
499
725
  | `generate_additive_process` | Philip Glass — expanding/contracting melody |
500
726
 
727
+ <br>
728
+
501
729
  ### Harmony (4)
730
+
502
731
  | Tool | Description |
503
732
  |------|-------------|
504
733
  | `navigate_tonnetz` | PRL neighbors at depth N |
@@ -506,7 +735,10 @@ claude plugin add github:dreamrec/LivePilot/plugin
506
735
  | `classify_progression` | Identify neo-Riemannian pattern |
507
736
  | `suggest_chromatic_mediants` | All chromatic mediant relations |
508
737
 
738
+ <br>
739
+
509
740
  ### MIDI I/O (4)
741
+
510
742
  | Tool | Description |
511
743
  |------|-------------|
512
744
  | `export_clip_midi` | Export clip to .mid file |
@@ -514,9 +746,11 @@ claude plugin add github:dreamrec/LivePilot/plugin
514
746
  | `analyze_midi_file` | Offline MIDI analysis |
515
747
  | `extract_piano_roll` | 2D velocity matrix extraction |
516
748
 
517
- ---
749
+ <br>
750
+
751
+ ───────────────────────────────────────────────────────────────
518
752
 
519
- ## Coming ────────────────────────────────────────
753
+ ## Coming
520
754
 
521
755
  ```
522
756
  □ Real-time DSP analysis via LOM meters
@@ -526,7 +760,9 @@ claude plugin add github:dreamrec/LivePilot/plugin
526
760
  □ Plugin parameter mapping — VST/AU deep control
527
761
  ```
528
762
 
529
- ---
763
+ <br>
764
+
765
+ ───────────────────────────────────────────────────────────────
530
766
 
531
767
  ## CLI
532
768
 
@@ -539,9 +775,15 @@ npx livepilot --doctor # Full diagnostic check
539
775
  npx livepilot --version # Show version
540
776
  ```
541
777
 
778
+ <br>
779
+
542
780
  ## Compatibility
543
781
 
544
- Live 12 all editions. Suite required for stock instruments (Drift, Meld, Wavetable) and Max for Live. Python 3.9+. Node.js 18+.
782
+ Live 12 all editions. Suite required for stock instruments
783
+ (Drift, Meld, Wavetable) and Max for Live.
784
+ Python 3.9+. Node.js 18+.
785
+
786
+ <br>
545
787
 
546
788
  ## Development
547
789
 
@@ -552,7 +794,9 @@ python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
552
794
  .venv/bin/pytest tests/ -v
553
795
  ```
554
796
 
555
- ---
797
+ <br>
798
+
799
+ ───────────────────────────────────────────────────────────────
556
800
 
557
801
  [MIT](LICENSE) — Pilot Studio
558
802
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "livepilot",
3
- "version": "1.7.3",
3
+ "version": "1.7.4",
4
4
  "mcpName": "io.github.dreamrec/livepilot",
5
5
  "description": "Agentic production system for Ableton Live 12 — 155 tools, 16 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
6
6
  "author": "Pilot Studio",