# Patchwright

> Visual node-graph builder for Ableton Live Extensions. Wire nodes (or describe them to PatchAI), preview against a simulated Live Set, design dialogs, and export a real installable `.ablx` — no TypeScript or terminal required.

Patchwright is for **Ableton Live producers** who want right-click tools and Set automation without learning the Extensions SDK by hand.

## Key URLs

- Home: https://patchwright.live/
- User Manual: https://patchwright.live/docs/
- Getting Started: https://patchwright.live/docs/getting-started
- Node Reference: https://patchwright.live/docs/node-reference
- Early access: https://patchwright.live/early-access
- Troubleshooting: https://patchwright.live/docs/troubleshooting

## What Patchwright does

- Visual **node graph** (Run wires + data wires) for Live Extension logic
- **Multiple triggers** in one project → multiple menu commands in Live
- **PatchAI** — describe tools in plain language; review before Build & Run
- **Dialog Designer** on the toolbar for extension UI
- **Build & Run** in Live (desktop) or **export `.ablx`** for install elsewhere
- Web-first core; Tauri desktop adds host bridge and hot reload

## Audience

Non-technical Ableton Live 12 Suite users (12.4.5+ with Extensions). Not a replacement for Max for Live realtime audio — Extensions run on context-menu triggers, offline structure editing.

## Documentation structure

- **Tutorials** — step-by-step lessons (transpose, PatchAI, export, etc.)
- **How-To guides** — one task each (choose trigger, clip color, host setup)
- **Node Reference** — which node to use, compatibility in plain language
- **Glossary** and **Troubleshooting**

## Optional

- Full port catalog (generated): see repository `docs/NODE-CATALOG.generated.md`
- Developer docs: repository `docs/DEVELOPMENT.md` (not for end users)