Skip to main content
Software

Public · MIT License

codex-live-bridge

Local-first Ableton Live automation and inspection through a Max for Live OSC/UDP bridge for Codex and scripts.

Open codex-live-bridge on GitHub

What it is

codex-live-bridge connects a local Ableton Live session to Codex and scripts through OSC/UDP. It supports inspection, observers, MIDI, and controlled writes.

The repository includes an editable Max patch, the JavaScript router loaded by the patch, and a Python client and command-line interface. Commands and responses stay on the local machine.

What you can do

  • Inspect Ableton Live state from Codex or a local script.
  • Receive acknowledgements and observer events from the running Live session.
  • Use MIDI, LiveAPI, and controlled write paths through one local bridge.
  • Work through the Live Extension or the external LiveUdpBridge surface.

What you need

  • Ableton Live with Max for Live support.
  • A local Codex surface: the Codex app, Codex CLI, or a Codex IDE extension.
  • Python 3.10 or later.
  • Live 12 Suite Beta 12.4.5 or later when using the Live Extension.

How to use it

  1. Clone and test the repository

    Clone codex-live-bridge, then run the included Python tests and JavaScript syntax check.

  2. Prepare the Max for Live device

    Export or obtain LiveUdpBridge.amxd and keep live_udp_bridge.js beside the device.

  3. Set a local write token

    Create one token for the local environment and the Max device. Keep real tokens out of the tracked source.

  4. Verify the connection

    Load the device in Ableton Live and run the read-focused status command from the repository.