livepilot 1.9.23 → 1.10.0

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "dreamrec-LivePilot",
-  "description": "Agentic MCP production system for Ableton Live 12 — 293 tools, 39 domains",
+  "description": "Agentic MCP production system for Ableton Live 12 — 316 tools, 43 domains",
   "owner": {
     "name": "dreamrec",
     "email": "dreamrec@users.noreply.github.com"
@@ -9,8 +9,8 @@
   "plugins": [
     {
       "name": "livepilot",
-      "description": "Agentic production system for Ableton Live 12 — 293 tools, 39 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
-      "version": "1.9.23",
+      "description": "Agentic production system for Ableton Live 12 — 316 tools, 43 domains, device atlas, spectral perception, technique memory, sample intelligence, auto-composition, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+      "version": "1.10.0",
       "author": {
         "name": "Pilot Studio"
       },

package/AGENTS.md

@@ -1,4 +1,4 @@
-# LivePilot v1.9.18 — Ableton Live 12
+# LivePilot v1.10.0 — Ableton Live 12
 
 ## Project
 - **Repo:** This directory (LivePilot)
@@ -22,7 +22,7 @@
 ## Key Rules
 - ALL Live Object Model (LOM) calls must execute on Ableton's main thread via schedule_message queue
 - Live 12 minimum — use modern note API (add_new_notes, get_notes_extended, apply_note_modifications)
-- 293 tools across 39 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine
+- 316 tools across 43 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine, song_brain, preview_studio, hook_hunter, stuckness_detector, wonder_mode, session_continuity, creative_constraints, device_forge, sample_engine, atlas, composer
 - JSON over TCP, newline-delimited, port 9878
 - Structured errors with codes: INDEX_ERROR, NOT_FOUND, INVALID_PARAM, STATE_ERROR, TIMEOUT, INTERNAL
 
@@ -43,4 +43,4 @@ When modifying .amxd attributes that Max editor won't persist (e.g., `openinpres
 4. Structure: 24-byte `ampf` header + `ptch` chunk + `mx@c` header + JSON patcher + frozen deps
 
 ## Tool Count
-Currently 257 tools. If adding/removing tools, update: README.md, package.json description, livepilot/.Codex-plugin/plugin.json, server.json, livepilot/skills/livepilot-core/SKILL.md, livepilot/skills/livepilot-core/references/overview.md, AGENTS.md, CHANGELOG.md, tests/test_tools_contract.py, docs/manual/index.md, docs/manual/tool-reference.md
+Currently 316 tools. If adding/removing tools, update: README.md, package.json description, livepilot/.Codex-plugin/plugin.json, livepilot/.claude-plugin/plugin.json, server.json, livepilot/skills/livepilot-core/SKILL.md, livepilot/skills/livepilot-core/references/overview.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, tests/test_tools_contract.py, docs/manual/index.md, docs/manual/tool-reference.md

package/CHANGELOG.md

@@ -1,5 +1,124 @@
 # Changelog
 
+## 1.10.0 — The Intelligence Release (April 13 2026)
+
+316 tools across 43 domains. Device Atlas v2, Sample Intelligence, Auto-Composition, Splice Integration, Device Forge, Live 12.3 API, Corpus Intelligence.
+
+### Device Atlas v2 — 1305 Devices, 81 Enriched (+6 tools)
+- **`atlas_search`** — fuzzy search across all devices by name, sonic character, use case, or genre
+- **`atlas_device_info`** — full knowledge entry for any device — parameters, recipes, gotchas
+- **`atlas_suggest`** — intent-driven recommendation: "warm bass for techno" → Drift + recipe
+- **`atlas_chain_suggest`** — full device chain for a track role: instrument + effects with rationale
+- **`atlas_compare`** — side-by-side comparison of two devices for a given role
+- **`scan_full_library`** — deep browser scan to build/refresh the atlas
+- 32 instruments (16 enriched), 70 audio effects (35 enriched), 23 MIDI effects (12 enriched), 497 M4L devices, 683 drum kits
+- 71 YAML enrichment files with parameter guides, recipes, and production knowledge
+
+### Composer Engine — Prompt to Multi-Layer Session (+3 tools)
+- **`compose`** — full multi-layer composition from text prompt ("dark minimal techno 128bpm with industrial textures")
+- **`augment_with_samples`** — add sample-based layers to existing session
+- **`get_composition_plan`** — dry run preview without executing
+- NLP parser extracts genre, mood, tempo, key, energy from free text
+- Layer planner with role templates (drums/bass/lead/pad/texture/vocal)
+- 7 genre defaults: techno, house, hip hop, ambient, drum and bass, trap, lo-fi
+- Credit safety system for Splice integration
+
+### Sample Engine — AI Sample Intelligence (+6 tools)
+- **`analyze_sample`**, **`evaluate_sample_fit`**, **`search_samples`**, **`suggest_sample_technique`**, **`plan_sample_workflow`**, **`get_sample_opportunities`**
+- SpliceSource — reads Splice's local sounds.db (read-only) for key, BPM, genre, tags, pack info, popularity
+- BrowserSource + FilesystemSource — Ableton browser and local directory scanning
+- 6-critic fitness battery: key fit, tempo fit, frequency fit, role fit, vibe fit, intent fit
+- 29-technique library: rhythmic (Dilla, Burial, Premier), textural (Paulstretch, granular), melodic (Bon Iver), resampling (Amon Tobin)
+- Dual philosophy: Surgeon (precision integration) vs Alchemist (creative transformation)
+- 6 sample-domain semantic moves for Wonder Mode: chop_rhythm, texture_layer, vocal_ghost, break_layer, resample_destroy, one_shot_accent
+- Sample-aware stuckness diagnosis: no_organic_texture, stale_drums, vocal_processing_monotony, dense_but_static
+
+### Splice gRPC Client
+- Live connection to Splice desktop API for downloading new samples
+- Port auto-detected from port.conf, TLS with self-signed certs
+- Credit safety floor (never drain below 5 credits)
+- Graceful degradation when Splice is not running
+
+### Device Forge — Programmatic M4L Generation (+3 tools)
+- **`generate_m4l_effect`**, **`list_genexpr_templates`**, **`install_m4l_device`**
+- .amxd binary builder from pure Python (reverse-engineered binary format)
+- gen~ DSP template library: 15 building blocks (Lorenz, Karplus-Strong, wavefolder, FDN reverb, bitcrusher, etc.)
+- 7 device_creation semantic moves for Wonder Mode
+- Safety: auto `clip(out, -1, 1)` on all generated gen~ code
+- Auto-installs to Ableton User Library
+
+### Live 12.3 API Integration (+4 tools)
+- **`create_native_arrangement_clip`** — arrangement clips with automation envelope (12.1.10+)
+- **`insert_device`** — insert native device by name, 10x faster than browser (12.3+)
+- **`insert_rack_chain`** — add chains to Instrument/Audio/Drum Racks (12.3+)
+- **`set_drum_chain_note`** — assign MIDI notes to Drum Rack chains (12.3+)
+- Version detection at startup with feature flags via `get_session_info`
+- Three capability tiers: Core (12.0+), Enhanced Arrangement (12.1.10+), Full Intelligence (12.3+)
+- Display values on device parameters (12.2+) — human-readable like "26.0 Hz"
+- `find_and_load_device` auto-routes to `insert_device` on 12.3+ (10x speedup)
+
+### Corpus Intelligence Layer
+- Parses device-knowledge markdown into queryable Python structures at runtime
+- EmotionalRecipe, GenreChain, PhysicalModelRecipe, AutomationGesture data types
+- Consumed by Wonder Mode, Sound Design critics, and Composer Engine
+
+### Wonder Mode Enhancements
+- Corpus intelligence integration — emotional/genre/material hints in variants
+- Sample-domain diagnosis patterns
+- 13 new semantic moves (6 sample + 7 device creation)
+
+### New Domains
+- **atlas** — device knowledge database (6 tools)
+- **composer** — auto-composition engine (3 tools)
+- **sample_engine** — sample intelligence (6 tools)
+- **device_forge** — M4L device generation (3 tools)
+
+## 1.9.24 — Stability & Intelligence Upgrade (April 2026)
+
+### Truth and Boundaries (Wave 1)
+- **feat(runtime):** Capability contract — every advanced tool reports `full/fallback/analytical_only/unavailable` with confidence scores
+- **feat(runtime):** Command boundary audit — CI catches any `send_command()` targeting a non-existent Remote Script command
+- **fix(song_brain):** `get_motif_graph` now uses pure-Python engine instead of invalid TCP call
+- **fix(hook_hunter):** Same motif routing fix
+- **fix(musical_intelligence):** Same motif routing fix + `analyze_phrase_arc` now calls perception engine directly
+- **fix(memory):** `record_positive_preference` actually updates taste dimensions (was a silent no-op due to key mismatch)
+- **fix(metadata):** AGENTS.md synced to v1.9.23/293 tools, test docstring corrected
+
+### Unified Execution Layer (Wave 2)
+- **feat(runtime):** Execution router — classifies steps as `remote_command/bridge_command/mcp_tool/unknown`, dispatches correctly
+- **feat(semantic_moves):** `apply_semantic_move` explore mode uses execution router
+- **feat(preview_studio):** `render_preview_variant` uses execution router
+
+### Persistent Memory (Waves 2-3)
+- **feat(persistence):** Base persistent JSON store (atomic write, corruption recovery, thread-safe)
+- **feat(persistence):** Taste store at `~/.livepilot/taste.json` — move outcomes, novelty band, device affinity, anti-preferences survive restart
+- **feat(persistence):** Project store at `~/.livepilot/projects/<hash>/state.json` — threads, turns, Wonder outcomes per song
+- **feat(memory):** TasteGraph.record_move_outcome writes to persistent backing
+- **feat(session_continuity):** tracker flushes threads and turns to project store on write
+
+### Move Annotations (Wave 3)
+- **feat(semantic_moves):** All 20 moves annotated with explicit `backend` per compile_plan step
+- **test:** Static audit verifies all annotations match the execution router classifier
+
+### Intelligence Upgrade (Waves 3-4)
+- **feat(services):** Shared motif service — one entry point consumed by SongBrain, HookHunter, musical_intelligence
+- **feat(song_brain):** Evidence-weighted identity confidence (motif=0.4, composition=0.2, roles=0.15, scenes=0.15, moves=0.1)
+- **feat(song_brain):** `evidence_breakdown` field shows per-source contributions
+- **feat(hook_hunter):** Hooks carry `evidence_sources` (motif_recurrence, track_name, clip_reuse)
+- **feat(hook_hunter):** Section-placement analysis boosts hooks recurring across sections
+- **feat(detectors):** Motif appearing in >60% of sections triggers fatigue signal
+
+### Preview and Doctor (Wave 4)
+- **feat(preview_studio):** Three explicit preview modes: `audible_preview` (M4L+spectrum), `metadata_only_preview`, `analytical_preview`
+- **feat(preview_studio):** `bars` parameter used for audible preview playback duration
+- **feat(preview_studio):** `preview_mode` field in response — no ambiguity about what was measured
+- **feat(runtime):** Capability probe — 6-area runtime detection (Ableton, Remote Script, M4L, numpy, persistence, tier)
+
+### Release Infrastructure (Wave 5)
+- **feat(scripts):** `sync_metadata.py` — single source of truth for version and tool count, CI-checkable
+- **docs:** README Intelligence Layer section with all 12 engines described
+- **docs:** Manual index rewritten with three-layer architecture and 39-domain map
+
 ## 1.9.23-wonder-v1.5 — Wonder Mode V1.5: Stuck-Rescue Workflow (April 2026)
 
 ### Wonder Mode Redesign (292->293 tools)

package/CONTRIBUTING.md

@@ -98,7 +98,7 @@ Prefix with `fix:`, `feat:`, `docs:`, `refactor:`, `test:`, or `chore:`.
 
 ## Tool Count Discipline
 
-Currently **293 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
+Currently **316 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
 
 - `README.md`
 - `CLAUDE.md`

package/README.md

@@ -13,11 +13,12 @@
   <a href="https://www.npmjs.com/package/livepilot"><img src="https://img.shields.io/npm/dm/livepilot?style=flat-square" alt="npm downloads"></a>
   <a href="https://github.com/dreamrec/LivePilot/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dreamrec/LivePilot?style=flat-square" alt="License"></a>
   <a href="https://github.com/dreamrec/LivePilot/releases"><img src="https://img.shields.io/github/v/release/dreamrec/LivePilot?style=flat-square&label=release" alt="Latest Release"></a>
+  <a href="https://www.patreon.com/c/dreamrec"><img src="https://img.shields.io/badge/Patreon-Support%20LivePilot-ff424d?style=flat-square&logo=patreon&logoColor=white" alt="Patreon"></a>
 </p>
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  293 tools. Device atlas. Spectral perception. Technique memory.
+  316 tools. Device atlas. Spectral perception. Technique memory.
 </p>
 
 <br>
@@ -37,10 +38,10 @@
 │   KNOWLEDGE            PERCEPTION           MEMORY          │
 │   ───────────          ──────────           ──────          │
 │                                                             │
-│   280+ devices         8-band FFT           recall by       │
-│   139 drum kits        RMS / peak           mood, genre,    │
-│   350+ impulse         pitch tracking       texture         │
-│   responses            key detection                        │
+│   1305 devices         8-band FFT           recall by       │
+│   81 enriched          RMS / peak           mood, genre,    │
+│   683 drum kits        pitch tracking       texture         │
+│   Splice catalog       key detection                        │
 │                                                             │
 │   ┌────────────┐      ┌────────────┐      ┌────────────┐   │
 │   │   Device   │─────▶│    M4L     │─────▶│ Technique  │   │
@@ -49,8 +50,8 @@
 │         └───────────────────┼───────────────────┘           │
 │                             ▼                               │
 │                    ┌─────────────────┐                      │
-│                    │   293 MCP Tools  │                      │
-│                    │   39 domains     │                      │
+│                    │   316 MCP Tools  │                      │
+│                    │   43 domains     │                      │
 │                    └────────┬────────┘                      │
 │                             │                               │
 │             Remote Script ──┤── TCP 9878                    │
@@ -71,7 +72,78 @@ 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 293 deterministic tools that execute on Ableton's main thread.
+All three feed into 316 deterministic tools that execute on Ableton's main thread.
+
+<br>
+
+---
+
+## The Intelligence Layer
+
+Most MCP servers are tool collections — they execute commands. LivePilot is an **agentic production system** — it understands what a song is becoming, diagnoses when a session is stuck, generates real creative options, learns from your decisions, and tracks its own impact.
+
+This is the V2 intelligence layer: 12 engines that sit on top of the 316 tools and give the AI musical judgment, not just musical execution.
+
+### SongBrain — What the Song Is
+
+SongBrain builds a real-time model of the current session: what the defining idea is (identity core), what elements must not be casually damaged (sacred elements), what each section is trying to do emotionally (section purposes), and where the energy arc is heading. It answers the question every producer asks: *"What is this track?"*
+
+It detects when the song's identity is drifting — when recent edits are pulling the track away from what made it work. When identity confidence is high, the system makes bolder suggestions. When it's fragile, it protects what's there.
+
+### Taste Graph — What You Like
+
+The Taste Graph learns your production preferences across sessions. Not just "prefers reverb" — it tracks which move families you keep vs. undo (mix moves? arrangement moves?), which devices you gravitate toward, how experimental you want suggestions to be (your novelty band), and which dimensions you actively avoid.
+
+Every time you accept or reject a suggestion, the graph updates. Over time, it personalizes which creative options are offered and how they're ranked. Two producers using the same tools get different recommendations.
+
+### Semantic Moves — Musical Actions, Not Parameters
+
+A semantic move is a high-level musical intent — "add contrast," "tighten the low end," "build tension toward the chorus" — that compiles into a specific sequence of tool calls. The system has 26+ moves across 6 families (mix, arrangement, transition, sound design, sample, device creation), each with an executable plan.
+
+Moves carry risk levels, target dimensions, and protection thresholds. "Add a filter sweep build" targets energy and tension while protecting clarity. The AI doesn't just know what to do — it knows what it's risking.
+
+### Wonder Mode — Stuck-Rescue Workflow
+
+When a session is stuck — too many undos, polishing the same loop, no structural progress — Wonder Mode activates. It's not "surprise me." It's a structured diagnosis-and-rescue workflow:
+
+1. **Diagnose** — Why is the session stuck? Repeated undos? Overpolished loop? Missing contrast? Identity unclear? The stuckness detector analyzes the action history and classifies the problem.
+
+2. **Generate** — Based on the diagnosis, Wonder searches for semantic moves that address the specific problem. It enforces real distinctness — each variant must differ by move family or execution approach. If only one real option exists, it says so honestly instead of relabeling the same idea three times.
+
+3. **Preview** — Each executable variant can be applied, captured, and undone using Ableton's undo system. You hear what each option would actually sound like before committing.
+
+4. **Commit or Reject** — Choose one, and the system records it into taste and session continuity. Reject all, and the creative thread stays open for another attempt. No fake outcomes are recorded.
+
+### Creative Engines
+
+Six specialized engines handle different aspects of production intelligence:
+
+| Engine | What it does |
+|--------|-------------|
+| **Mix Engine** | Critic-driven mix analysis. Identifies masking, headroom issues, stereo problems. Plans corrective moves with before/after evaluation. |
+| **Sound Design Engine** | Analyzes patches for static timbre, missing modulation, weak transients. Suggests parameter moves and evaluates the result. |
+| **Transition Engine** | Classifies transition types (drop, build, breakdown). Scores transition quality and plans improvements using archetypes. |
+| **Composition Engine** | Analyzes song structure, detects motifs, infers section purposes, scores emotional arcs. Plans arrangement moves. |
+| **Performance Engine** | Safety-constrained suggestions for live performance. Knows which moves are safe during playback and which risk audio dropouts. |
+| **Reference Engine** | Distills principles from reference tracks. Maps those principles to your current session as concrete, actionable moves. |
+
+### Hook Hunter — Finding What Matters
+
+The Hook Hunter identifies the most salient musical idea in a session — the element listeners would remember. It ranks candidates by rhythmic distinctiveness, melodic contour, and repetition. Then it tracks whether hooks are being developed, neglected, or undermined by arrangement choices.
+
+When the hook is strong but underused, it flags it. When a transition fails to deliver the expected payoff, it diagnoses why.
+
+### Session Continuity — The Story of Your Session
+
+Session Continuity tracks what happened, what changed, and what's still unresolved. It maintains creative threads (open questions like "the chorus needs more lift") and records turn resolutions (what you tried, whether you kept it, how it affected identity).
+
+When you return to a project, the session story tells the AI: *"Last time, you were working on making the bridge darker. You tried three approaches and kept the filter sweep. The chorus lift thread is still open."*
+
+### Evaluation Loop — Verify Before Claiming Success
+
+Every creative engine follows the same discipline: **measure before, act, measure after, compare**. The evaluation system captures session state snapshots, runs the change, captures again, and scores the difference. If the change made things worse — more masking, lost headroom, identity drift — the system flags it before you move on.
+
+This closes the gap between "the AI did something" and "the AI did something that actually helped."
 
 <br>
 
@@ -79,7 +151,7 @@ All three feed into 293 deterministic tools that execute on Ableton's main threa
 
 ## Tools
 
-293 tools across 39 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+316 tools across 43 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -91,11 +163,11 @@ All three feed into 293 deterministic tools that execute on Ableton's main threa
 | Tracks | 17 | create MIDI/audio/return, delete, duplicate, arm, mute, solo, color, freeze, flatten |
 | Clips | 11 | create, delete, duplicate, fire, stop, loop, launch mode, warp mode, quantize |
 | Notes | 8 | add/get/remove/modify MIDI notes, transpose, duplicate, per-note probability |
-| Devices | 15 | load by name or URI, get/set parameters, batch edit, racks, chains, presets, plugin deep control |
+| Devices | 19 | load by name or URI, insert native (12.3+), get/set parameters, batch edit, racks, chains, drum chain note assignment, presets, plugin deep control |
 | Scenes | 12 | create, delete, duplicate, fire, name, color, tempo, scene matrix |
 | Browser | 4 | search library, browse tree, load items, filter by category |
 | Mixing | 11 | volume, pan, sends, routing, meters, return tracks, master, full mix snapshot |
-| Arrangement | 19 | timeline clips, arrangement notes, arrangement automation, recording, cue points |
+| Arrangement | 21 | timeline clips, native arrangement clips (12.1.10+), arrangement notes, arrangement automation, recording, cue points |
 
 <br>
 
@@ -105,7 +177,7 @@ The M4L Analyzer sits on the master track. UDP 9880 carries spectral data
 from Max to the server. OSC 9881 sends commands back.
 
 > [!TIP]
-> All 207 core tools work without the analyzer — it adds 30 more and closes the feedback loop.
+> All 289 core tools work without the analyzer — it adds 27 bridge tools and closes the feedback loop.
 
 ```
 SPECTRAL ─────── 8-band frequency decomposition (sub → air)
@@ -322,7 +394,34 @@ read_audio_metadata     Format, duration, sample rate, tags
 
 <br>
 
-> **[View all 293 tools →](docs/manual/tool-catalog.md)**
+### Agentic Intelligence — 106 tools
+
+The V2 intelligence layer. These tools don't just execute commands — they analyze, diagnose, plan, evaluate, and learn.
+
+| Domain | # | What it does |
+|--------|:-:|-------------|
+| Agent OS | 8 | session kernel, action ledger, capability state, routing, turn budget |
+| Composition | 9 | section analysis, motif detection, emotional arc, form planning, section transforms |
+| Evaluation | 1 | before/after evaluation with structured scoring |
+| Mix Engine | 6 | critic-driven mix analysis, issue detection, move planning, masking reports |
+| Sound Design | 4 | patch analysis, modulation planning, timbre scoring |
+| Transition Engine | 5 | transition classification, scoring, archetype-based planning |
+| Reference Engine | 5 | reference profiling, principle distillation, gap analysis, move mapping |
+| Translation Engine | 3 | cross-domain translation, issue detection |
+| Performance Engine | 3 | safety-constrained suggestions, safe move lists, scene handoff planning |
+| Song Brain | 3 | identity inference, sacred element detection, drift monitoring |
+| Hook Hunter | 9 | hook detection, salience scoring, development strategies, neglect detection, phrase impact |
+| Stuckness Detector | 3 | momentum analysis, rescue classification, structured rescue workflows |
+| Wonder Mode | 3 | diagnosis-driven variant generation, taste-aware ranking, session discard |
+| Session Continuity | 7 | creative threads, turn resolution, taste vs identity ranking, session story |
+| Creative Constraints | 5 | constraint activation, reference-inspired variants, constrained generation |
+| Preview Studio | 5 | variant creation, preview rendering, comparison, commit, discard |
+| **Device Atlas** | **6** | **search 1305 devices, suggest by intent, chain building, device comparison, library scan** |
+| **Sample Engine** | **6** | **multi-source sample search (Splice/Browser/filesystem), fitness critics, technique library** |
+| **Device Forge** | **3** | **generate M4L devices from gen~ templates, install to browser** |
+| **Composer** | **3** | **prompt → multi-layer composition, sample augmentation, plan preview** |
+
+> **[View all 316 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -372,6 +471,11 @@ claude mcp add LivePilot -- npx livepilot
 claude plugin add github:dreamrec/LivePilot/plugin
 ```
 
+**Codex App:**
+```bash
+npx livepilot --install-codex-plugin
+```
+
 **Claude Desktop (macOS)** — `~/Library/Application Support/Claude/claude_desktop_config.json`:
 ```json
 {
@@ -441,6 +545,17 @@ npx livepilot --status
 
 ## Plugin
 
+**Codex App**
+
+```bash
+npx livepilot --install-codex-plugin
+```
+
+Installs the bundled plugin into `~/plugins/livepilot` and registers it in
+`~/.agents/plugins/marketplace.json`.
+
+**Claude Code**
+
 ```bash
 claude plugin add github:dreamrec/LivePilot/plugin
 ```
@@ -471,6 +586,8 @@ Check memory before creative decisions. Verify every mutation.
 npx livepilot              # Start MCP server (stdio)
 npx livepilot --install    # Install Remote Script
 npx livepilot --uninstall  # Remove Remote Script
+npx livepilot --install-codex-plugin   # Install bundled Codex plugin
+npx livepilot --uninstall-codex-plugin # Remove bundled Codex plugin
 npx livepilot --status     # Check Ableton connection
 npx livepilot --doctor     # Full diagnostic check
 npx livepilot --version    # Show version
@@ -518,6 +635,20 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 ---
 
+## Support
+
+LivePilot is free and open source. Building it takes hundreds of hours, an Ableton Suite license, and a Claude subscription. If LivePilot saves you time in your sessions, consider supporting development:
+
+<p align="center">
+  <a href="https://www.patreon.com/c/dreamrec"><strong>Support on Patreon</strong></a> · <a href="https://github.com/sponsors/dreamrec">GitHub Sponsors</a>
+</p>
+
+Supporters get early access to new features, premium skills, curated technique libraries, and direct support.
+
+<br>
+
+---
+
 <p align="center">
   <a href="LICENSE">MIT</a> — Pilot Studio
   <br><br>

package/bin/livepilot.js

@@ -211,6 +211,45 @@ function checkStatus() {
   });
 }
 
+function probeAnalyzer(venvPy) {
+  const probeCode = `
+import asyncio
+import json
+import sys
+from types import SimpleNamespace
+
+sys.path.insert(0, ${JSON.stringify(ROOT)})
+
+from mcp_server.server import lifespan, _master_has_livepilot_analyzer
+from mcp_server.runtime.capability_probe import probe_capabilities
+
+async def main():
+    async with lifespan(None) as ctx:
+        loaded = _master_has_livepilot_analyzer(ctx["ableton"])
+        report = probe_capabilities(
+            ableton=ctx["ableton"],
+            ctx=SimpleNamespace(lifespan_context=ctx),
+        )
+        print(json.dumps({
+            "loaded_on_master": loaded,
+            "m4l_bridge": report["m4l_bridge"],
+            "tier": report["tier"]["active"],
+        }))
+
+asyncio.run(main())
+`;
+
+  const out = execFileSync(venvPy, ["-c", probeCode], {
+    cwd: ROOT,
+    encoding: "utf-8",
+    timeout: 15000,
+    stdio: ["pipe", "pipe", "pipe"],
+  }).trim();
+
+  const lines = out.split(/\r?\n/).filter(Boolean);
+  return JSON.parse(lines[lines.length - 1]);
+}
+
 // ---------------------------------------------------------------------------
 // Doctor — comprehensive diagnostic
 // ---------------------------------------------------------------------------
@@ -312,6 +351,37 @@ async function doctor() {
     ok = false;
   }
 
+  // 9. Analyzer / bridge capability
+  if (connected && fs.existsSync(venvPy)) {
+    const HOST = process.env.LIVE_MCP_HOST || "127.0.0.1";
+    const PORT = parseInt(process.env.LIVE_MCP_PORT || "9878", 10);
+    const otherClient = findOtherLiveClient(HOST, PORT);
+
+    if (otherClient) {
+      console.log("  Analyzer: skipped (another LivePilot client is connected: %s)", otherClient);
+    } else {
+      try {
+        const analyzer = probeAnalyzer(venvPy);
+        if (analyzer.loaded_on_master) {
+          console.log(
+            "  Analyzer: %s",
+            analyzer.m4l_bridge.status === "ok"
+              ? "loaded on master and bridge is active"
+              : `loaded on master but bridge unavailable (${analyzer.m4l_bridge.detail})`,
+          );
+          if (analyzer.m4l_bridge.status !== "ok") {
+            ok = false;
+          }
+        } else {
+          console.log("  Analyzer: not detected on master track (optional)");
+        }
+      } catch (err) {
+        console.log("  Analyzer: could not probe (%s)", err.message || String(err));
+        ok = false;
+      }
+    }
+  }
+
   // Summary
   console.log("");
   console.log("─".repeat(50));
@@ -580,6 +650,7 @@ async function setup() {
     console.log("  3. Set Control Surface to 'LivePilot'");
     console.log("  4. Start making music with AI!");
     console.log("");
+    console.log("  Codex App:      npx livepilot --install-codex-plugin");
     console.log("  Claude Code:    claude mcp add LivePilot -- npx livepilot");
     console.log("  Claude Desktop: Already configured if using Desktop Extension");
   } else {
@@ -613,6 +684,8 @@ async function main() {
     console.log("  --setup       Full setup wizard (install + configure + test)");
     console.log("  --install     Install Remote Script into Ableton Live");
     console.log("  --uninstall   Remove Remote Script from Ableton Live");
+    console.log("  --install-codex-plugin   Install the bundled Codex plugin locally");
+    console.log("  --uninstall-codex-plugin Remove the locally installed Codex plugin");
     console.log("  --status      Check if Ableton Live is reachable");
     console.log("  --doctor      Run diagnostics (Python, deps, connection)");
     console.log("  --version     Show version");
@@ -639,6 +712,20 @@ async function main() {
     return;
   }
 
+  // --install-codex-plugin
+  if (flag === "--install-codex-plugin") {
+    const { installCodexPlugin } = require(path.join(ROOT, "installer", "codex.js"));
+    installCodexPlugin();
+    return;
+  }
+
+  // --uninstall-codex-plugin
+  if (flag === "--uninstall-codex-plugin") {
+    const { uninstallCodexPlugin } = require(path.join(ROOT, "installer", "codex.js"));
+    uninstallCodexPlugin();
+    return;
+  }
+
   // --status
   if (flag === "--status") {
     const reachable = await checkStatus();