Skip to content
Back to search

audio-plugin-coder

Audio Plugin Coder (APC) is a groundbreaking, open-source framework that enables musicians, producers, sound designers, and developers to create professional VST3/AU audio plugins using natural language and AI assistance. Built on JUCE 9 and powered by a revolutionary 5-phase workflow system.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/noizefield--audio-plugin-coder/badge.svg)](/listings/noizefield--audio-plugin-coder)

HTML

<a href="/listings/noizefield--audio-plugin-coder"><img src="/api/listings/noizefield--audio-plugin-coder/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

One-command setup

npx github:Noizefield/audio-plugin-coder

Clones, checks your tools, and prints next steps for your platform. Requires [Node.js 18+](https://nodejs.org) and [Git](https://git-scm.com).

Manual setup

# Windows
git clone --recurse-submodules https://github.com/Noizefield/audio-plugin-coder.git
cd audio-plugin-coder
.\scripts\system-check.ps1 -Human
# macOS / Linux
git clone --recurse-submodules https://github.com/Noizefield/audio-plugin-coder.git
cd audio-plugin-coder
bash scripts/system-check.sh --human

Then open the repo in your agent and run `/apc-setup`, then `/apc-dream <PluginName>`.

Prerequisites

| Platform | Requirements | |---|---| | **Windows** | LLM agent, Git, Node.js 18+, Python 3.8+, Visual Studio 2022 C++, CMake 3.22+, WebView2 Runtime, JUCE 9 (submodule), pluginval (submodule) | | **macOS** | LLM agent, macOS 10.13+, Xcode + CLT, CMake 3.22+, Git, Node.js 18+, Python 3.8+, jq, JUCE 9, pluginval (WKWebView, no WebView2) | | **Linux** | LLM agent, GCC 9+ / Clang 10+, C++20, CMake 3.22+, Make/Ninja, Node.js 18+, Python 3.8+, WebKitGTK, libegl-dev, ALSA (+JACK), JUCE 9, pluginval |

Bridge Templates (FFGL & Max/MSP)

For FFGL visual plugins or Max for Live externals, run the Windows one-click setup:

.\scripts\setup_bridges.bat

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 289 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Audio Plugin Coder (APC)
  2. ![Audio Plugin Coder Logo](https://github.com/Noizefield/audio-plugin-coder/blob/main/assets/APC_Logo.gif)
  3. > AI-powered open-source framework for vibe-coding audio plugins from concept to shipped product
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  5. [![Version](https://img.shields.io/github/package-json/v/Noizefield/audio-plugin-coder)](https://github.com/Noizefield/audio-plugin-coder/blob/main/package.json)
  6. [![JUCE](https://img.shields.io/badge/JUCE-9.0-blue.svg)](https://juce.com/)
  7. [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-0078D4.svg)](https://github.com/Noizefield/audio-plugin-coder)
  8. [![HOL Guard Scanner](https://img.shields.io/badge/HOL%20Guard-passing-00a67e)](https://github.com/hashgraph-online/hol-guard)
  9. [![Sponsor](https://img.shields.io/badge/Sponsor-Project-pink.svg?style=social&logo=heart)](https://github.com/sponsors/Noizefield)
  10. ## What's new
  11. ### v1.8.0
  12. **CLAP plugin format (beta).** New plugins can now opt into a CLAP build during `/apc-plan` — [clap-juce-extensions](https://github.com/free-audio/clap-juce-extensions) wraps the same JUCE `AudioProcessor` and editor, so no plugin-code changes are needed: it emits a `<Name>_CLAP` target producing `Name.clap` alongside VST3/Standalone. Builds, per-user install (no admin on Windows), `clap-validator` runs, Inno installer component and macOS DMG folder are all wired end-to-end; `plugins/ClapSmokeTest` is the canonical opt-in example and `clap.id_prefix` in `apc.config.json` controls plugin IDs.
  13. > **Beta disclaimer:** CLAP support is new and **could not be fully tested yet** — a basic plugin configures, builds, validates and loads, but it has not been battle-tested across DAWs. Known limitation: `clap-validator`'s `state-reproducibility-*` tests fail on all JUCE/APVTS plugins due to an upstream wrapper bug (tracked as `clap-001`, fix pending in [clap-juce-extensions#189](https://github.com/free-audio/clap-juce-extensions/pull/189); harmless in real hosts). Please report anything odd.
  14. ### v1.7.0
  15. **Your AI assistant can now split big jobs across a team of subagents.**
  16. Type `/apc-orchestrate <goal>` and APC acts as the orchestrator: it breaks the work into independent pieces, hands them to worker agents (four tiers, from `cheap-worker` for searches up to `expert-worker` for the really hard stuff), runs them in parallel, verifies the results for real, and merges everything back. It works the same way across Devin, Claude Code, OpenCode, Codex and friends — worker profiles live once in `.agents/agents/` and a `sync-agents` script generates the per-host copies. On hosts without subagents, workers run as headless CLI calls or sequentially instead.
  17. ### v1.6.0
  18. **A shared layout contract for plugin UIs.** A rem-grid system plus a `ui-map` manifest describe what the UI actually looks like, `ui-lint` gates it, and the Hub can review the result — so generated interfaces stay consistent instead of drifting.
  19. **Visage and Windows got tougher.** Adaptive raster recovery, Windows crash minidumps for real debugging, and the crash handler only wraps Standalone builds now. Devin CLI also joined as a first-class host with `/apc-*` command adapters.
  20. **Builds got sturdier (v1.5.1 + v1.6.0).** CMake resolution now finds a *working* compiler even with a broken shim on PATH, failed builds are correctly reported as failures, pluginval gets the right strictness flag, and compiler parallelism is capped so big JUCE builds stop running out of memory.
  21. ### v1.5.0
  22. APC 1.5 is a big step forward - especially if you are a musician or hobbyist who just wants to build your own plugin without fighting tooling. Here is what changed, in plain words.
  23. **The APC Hub - a window into your whole project.**
  24. Instead of digging through folders and config files, you now get a live dashboard in your browser. Type `/apc-hub` (or run `node hub/server.js`) and you can see every plugin at a glance - which phase it is in, what still needs to be done, your design library, scripts, templates, tools and settings. Documentation is searchable and readable right there. You can even adjust your settings from a simple form instead of hand-editing JSON. It is read-only by default, so nothing breaks by accident.
  25. **Works with more AI coding tools than ever.**
  26. APC used to be picky about which assistant you used. In 1.5 that changed:
  27. - **Codex is now fully on board.** Codex could not use slash commands like other assistants - APC now ships a proper Codex skill and plugin, with dedicated commands and optional cost-aware model routing (Luna, Terra, Sol, Astra).
  28. - **Cursor is supported.** APC is ready out of the box in Cursor, including custom rules.
  29. - **OpenCode is supported too.** All APC commands are wired up for it, exactly like Claude Code and Kilo.
  30. **A single command-line tool.**
  31. All the important tasks - version, paths, build, validate, backup, rollback, status - are now in one cross-platform tool (`apc`), tested by an automated suite. No more hunting for the right script.
  32. **Improve and extend your plugins after release.**
  33. Shipped a plugin? `/apc-patch` opens a focused bugfix round, `/apc-evolve` starts a feature upgrade. Your version number and state stay consistent automatically.
  34. **Everything else got tidier too.**
  35. Docs were rewritten to match reality, the framework version has one single source of truth, and releases now land in a clean `release/` folder that honors your configured paths.
  36. Start: clone -> `/apc-setup` (Claude Code / Kilo / Cursor / OpenCode) or `$audio-plugin-coder:audio-plugin-coder setup` (Codex) -> `/apc-dream MyPlugin`.
  37. ## APC Hub
  38. The APC Hub gives you a complete, live overview of the framework and your plugins - no build required, read-only by default:
  39. ```bash
  40. node hub/server.js --port 4872 # or: /apc-hub in your agent
  41. ```
  42. ![APC Hub dashboard](assets/apc_hub_screenshot.jpg)
  43. ## Video Tutorial Series
  44. <a href="https://www.youtube.com/watch?v=tD6T8MEGmW8&list=PLEOCbFL_Mq4o" target="_blank">
  45. <img src="assets/apc_walkthrough.jpg" alt="APC tutorial series - click to watch on YouTube">
  46. </a>
  47. **APC Tutorial Series (YouTube Playlist)** - 10 episodes, explaining the framework in detail.
  48. - Play the video: https://www.youtube.com/watch?v=tD6T8MEGmW8&list=PLEOCbFL_Mq4o
  49. - Open the playlist on YouTube: https://www.youtube.com/playlist?list=PLEOCbFL_Mq4o
  50. ## About
  51. **Audio Plugin Coder (APC)** is an AI-first framework that guides LLM agents through the whole plugin lifecycle - ideation, architecture, UI, DSP implementation, testing, and packaging - without the agent re-learning JUCE or your conventions every session. It is agent-agnostic (Codex, Claude Code, Kilo, Cursor, Antigravity) and has been hardened over 18 months of real plugin development.
  52. The core workflow - `setup -> dream -> plan -> design -> impl -> ship` - is ready for production on Windows, macOS, and Linux.
  53. ## Which AI Coding Tools Work with APC?
  54. APC is agent-agnostic: pick the assistant you already use. In v1.5.0 all major ones are first-class:
  55. | Assistant | Status | How APC talks to it |
  56. |---|---|---|
  57. | **Codex** | ✅ Fully supported in 1.5.0 | Codex does not use slash commands - it gets a dedicated `audio-plugin-coder` skill and plugin with cost-aware model routing |
  58. | **Cursor** | ✅ Ready out of the box | Custom rules + `/apc-*` commands, project guidance via `AGENTS.md` |
  59. | **OpenCode** | ✅ Fully wired up | `/apc-*` commands with dedicated host shims |
  60. | **Claude Code** | ✅ Fully supported | `/apc-*` commands |
  61. | **Kilo** | ✅ Fully supported | `/apc-*` commands |
  62. | **Antigravity / Gemini** | ✅ Supported | Natural language + `AGENTS.md` guidance |
  63. Previously Cursor, OpenCode and Codex had only partial support. In 1.5.0 they now work the same way as Claude Code and Kilo - no workarounds needed.
  64. ## Key Features
  65. - **LLM-driven development** - works with any coding agent
  66. - **Guided setup** - `/apc-setup` configures toolchain, paths, and model routing via `apc.config.json`
  67. - **Structured workflows** - Dream -> Plan -> Design -> Implement -> Ship, plus test/debug/status/resume/patch/evolve/hub
  68. - **Unique slash commands** - `/apc-*` primary names; short aliases kept as deprecated
  69. - **Dual UI frameworks** - Visage (pure C++) or WebView (HTML/CSS/JS + JUCE WebView)
  70. - **State management** - per-plugin `status.json` with progress, validation, rollback
  71. - **Self-improving** - auto-captured troubleshooting knowledge
  72. - **JUCE 9 + CMake** - relocatable plugins/build/release directories
  73. - **APC Hub** - live local dashboard and future workbench (`/apc-hub`)
  74. ## Quick Start
  75. ### One-command setup
  76. ```bash
  77. npx github:Noizefield/audio-plugin-coder
  78. ```
  79. Clones, checks your tools, and prints next steps for your platform. Requires [Node.js 18+](https://nodejs.org) and [Git](https://git-scm.com).
  80. ### Manual setup
  81. ```powershell
  82. # Windows
  83. git clone --recurse-submodules https://github.com/Noizefield/audio-plugin-coder.git
  84. cd audio-plugin-coder
  85. .\scripts\system-check.ps1 -Human
  86. ```
  87. ```bash
  88. # macOS / Linux
  89. git clone --recurse-submodules https://github.com/Noizefield/audio-plugin-coder.git
  90. cd audio-plugin-coder
  91. bash scripts/system-check.sh --human
  92. ```
  93. Then open the repo in your agent and run `/apc-setup`, then `/apc-dream <PluginName>`.
  94. ### Prerequisites
  95. | Platform | Requirements |
  96. |---|---|
  97. | **Windows** | LLM agent, Git, Node.js 18+, Python 3.8+, Visual Studio 2022 C++, CMake 3.22+, WebView2 Runtime, JUCE 9 (submodule), pluginval (submodule) |
  98. | **macOS** | LLM agent, macOS 10.13+, Xcode + CLT, CMake 3.22+, Git, Node.js 18+, Python 3.8+, jq, JUCE 9, pluginval (WKWebView, no WebView2) |
  99. | **Linux** | LLM agent, GCC 9+ / Clang 10+, C++20, CMake 3.22+, Make/Ninja, Node.js 18+, Python 3.8+, WebKitGTK, libegl-dev, ALSA (+JACK), JUCE 9, pluginval |
  100. ### Bridge Templates (FFGL & Max/MSP)
  101. For FFGL visual plugins or Max for Live externals, run the Windows one-click setup:
  102. ```powershell
  103. .\scripts\setup_bridges.bat
  104. ```
  105. ## How It Works
  106. ### The Five-Phase Workflow
  107. ```
  108. SETUP -> First-run toolchain, paths, model preferences
  109. DREAM -> Creative brief, parameter spec
  110. PLAN -> Architecture, UI framework, complexity
  111. DESIGN -> GUI mockups and visual design
  112. IMPL -> DSP engine and UI integration
  113. SHIP -> Installers, DAW testing, distribution
  114. ```
  115. ### Agent Commands
  116. Prefer the `/apc-*` names (unique across frameworks). Short aliases (`/dream`, ...) still work as deprecated. Codex invokes actions through the `audio-plugin-coder` skill (bare `/plan`/`/status` are Codex built-ins).
  117. | Primary | Codex action | Description |
  118. |---|---|---|
  119. | `/apc-setup` | `$audio-plugin-coder:audio-plugin-coder setup` | First-run toolchain, paths, models |
  120. | `/apc-dream [Name]` | `... dream [Name]` | Start new plugin (ideation) |
  121. | `/apc-plan [Name]` | `... plan [Name]` | Architecture + UI framework |
  122. | `/apc-design [Name]` | `... design [Name]` | GUI mockups and visual design |
  123. | `/apc-impl [Name]` | `... impl [Name]` | Implement DSP and UI |
  124. | `/apc-test [Name]` | `... test [Name]` | Run tests / validation |
  125. | `/apc-debug [Name]` | `... debug [Name]` | Diagnose and fix issues |
  126. | `/apc-ship [Name]` | `... ship [Name]` | Package and distribute |
  127. | `/apc-status [Name]` | `... status [Name]` | Progress and state |
  128. | `/apc-resume [Name]` | `... resume [Name]` | Continue from last incomplete phase |
  129. | `/apc-new [Name]` | `... new [Name]` | Full workflow with confirmations |
  130. | `/apc-patch [Name]` | `$audio-plugin-coder:audio-plugin-coder patch [Name]` | Bugfix generation on a shipped plugin |
  131. | `/apc-evolve [Name]` | `$audio-plugin-coder:audio-plugin-coder evolve [Name]` | Feature generation on a shipped plugin |
  132. | `/apc-hub` | `$audio-plugin-coder:audio-plugin-coder hub` | Open the live local dashboard |
  133. | `/apc-orchestrate <goal>` | `$audio-plugin-coder:audio-plugin-coder orchestrate <goal>` | Decompose a goal across subagent workers |
  134. See [Command Reference](docs/command-reference.md), [Codex Compatibility](docs/codex-compatibility.md), [Orchestration](docs/orchestration.md), and [Model Routing](docs/model-routing.md).
  135. ### Example Session
  136. ```
  137. You: /apc-setup
  138. AI: ✅ Setup complete. Next: /apc-dream <PluginName>
  139. You: /apc-dream TapeDelay / "Warm analog tape delay with wow/flutter"
  140. AI: ✅ Dream phase complete! Files created: .ideas/creative-brief.md, .ideas/parameter-spec.md, status.json
  141. You: /apc-design TapeDelay / "Teal dashboard, skeumorphic knobs"
  142. AI: ✅ Design complete! Next: /apc-impl TapeDelay
  143. ```
  144. ## Architecture
  145. APC tracks every plugin in a `status.json` (phase, validation, rollback). That lets you pause, switch agents, or rebuild state at any time.
  146. ```
  147. audio-plugin-coder/
  148. ├── AGENTS.md # Agent guidance (AGENTS.md standard)
  149. ├── .agents/ # Canonical source: workflows/, skills/, rules/, guides/, troubleshooting/
  150. ├── .codex-plugin/ # Codex plugin manifest
  151. ├── skills/ # Packaged Codex skill (points at .agents/)
  152. ├── hub/ # APC Hub - server.js, ui/, _design/
  153. ├── templates/ # Plugin templates (visage, webview, ffgl, max-external)
  154. ├── docs/ # Documentation (16 files)
  155. ├── scripts/ # Build / state / validation automation (ps1 + sh)
  156. ├── bin/ # setup.js, apc.js CLI
  157. ├── common/ # Shared helpers (e.g. VisageJuceHost.h)
  158. ├── plugins/ # Your plugins (config-relocatable)
  159. ├── build/ # Compilation artifacts
  160. ├── release/ # Ship packages (installers, zips)
  161. └── test/ # apc.js test suite (npm test)
  162. ```
  163. Workflows orchestrate skills: `/apc-design` reads your UI framework from `status.json`, then loads the matching design skill. Troubleshooting auto-captures issues so the system improves over time.
  164. ## UI Framework Options
  165. - **Visage (pure C++) - experimental** - Native frames, high performance, full C++ control.
  166. - **WebView (HTML/CSS/JS)** - Modern web tech, hot reload, rich visualization.
  167. The AI recommends a framework during planning based on your plugin's complexity.
  168. ## Supported Plugin Formats
  169. | Format | Windows | macOS | Linux |
  170. |---|---|---|---|
  171. | VST3 | ✅ | ✅ | ✅ |
  172. | Standalone | ✅ | ✅ | ✅ |
  173. | AU | ❌ | ✅ | ❌ |
  174. | LV2 | ❌ | ❌ | ✅ |
  175. | CLAP | ✅* | ✅* | ✅* |
  176. *\* Opt-in per plugin (chosen during `/apc-plan`, via `clap-juce-extensions`). **Beta — not yet battle-tested across DAWs** (see What's new).*
  177. ## Technology Stack
  178. JUCE 9, CMake, PowerShell/Bash, WebView2 / WKWebView, YAML knowledge base, Node.js (CLI + Hub).
  179. ## Documentation
  180. Docs live in [`docs/`](docs/): [Getting Started](docs/README.md), [Plugin Development Lifecycle](docs/plugin-development-lifecycle.md), [Command Reference](docs/command-reference.md), [Hub](docs/hub.md), [FAQ](docs/FAQ.md), [Troubleshooting](docs/troubleshooting-guide.md). The Hub serves them as a searchable reader.
  181. ## Roadmap
  182. - [x] Windows / macOS / Linux local builds
  183. - [x] GitHub Actions CI/CD, docs-as-truth, `apc` CLI, APC Hub
  184. - [x] Visage + WebView UIs, FFGL + Max/MSP bridge templates
  185. - [x] Codex, Cursor and OpenCode support
  186. - [x] CLAP format support (opt-in per plugin)
  187. - [ ] Preset management, plugin marketplace, real-time collaboration
  188. ## Contributing & Community
  189. Join [GitHub Discussions](https://github.com/Noizefield/audio-plugin-coder/discussions); see [CONTRIBUTING.md](CONTRIBUTING.md).
  190. ## Sponsor
  191. Independent development with significant API costs. If APC saves you time, consider [sponsoring](https://github.com/sponsors/Noizefield) - it covers API costs and accelerates new features.
  192. ## Acknowledgments
  193. - **JUCE Team** - the industry-standard framework
  194. - **The AI community** - specifically the meta-prompting pioneers
  195. - **Matt Tytel** - the Visage library (https://github.com/VitalAudio/visage)
  196. - **[12Matt3r](https://github.com/12Matt3r)** - FFGL and Max/MSP bridge templates
  197. - **[vjcharles](https://github.com/vjcharles)** - macOS support and security hardening (PR #6)
  198. ## License
  199. MIT - see [LICENSE.md](LICENSE.md). Note: APC itself is MIT, but plugins built with it inherit JUCE's dual license (AGPLv3 free, or a [JUCE commercial license](https://juce.com/pricing/) for closed-source). [JUCE terms](https://juce.com/legal/juce-licence/).
  200. ---
  201. *Built with a lot of tokens for the audio development community. Turn your plugin ideas into reality.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.