Skip to content

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 8 and powered by a revolutionary 5-phase workflow system.

License

Notifications You must be signed in to change notification settings

Noizefield/audio-plugin-coder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

14 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Audio Plugin Coder (APC)

Audio Plugin Coder Logo

AI-powered framework for vibe-coding audio plugins from concept to shipped product

License: MIT JUCE Platform Sponsor

About Audio Plugin Coder

Audio Plugin Coder (APC) is the result of a long-standing personal obsession: building creative tools, writing music, and ultimately creating professional audio plugins.

While developing software instruments and effects has always been a dream, building real-world VSTs (with robust DSP, UI, state handling, and packaging) is notoriously complex. Over time, and especially with the rapid advancement of AI-assisted development, that barrier has finally crumbled.

Over the past 18 months, APC has been continuously designed, tested, and re-iterated as a practical AI-first framework for building audio plugins. This involved thousands of hours of experimentation, trial-and-error, and yes... occasionally yelling at LLMs to finally render the UI correctly.

Midway through development, I stumbled upon the excellent work of Tร‚CHES (glittercowboy). His approach to context engineering was a revelation. I adopted some of his core ideas, particularly regarding meta prompting and structured agent workflows and integrated them directly into APC's DNA to create a more robust system.

APC is designed to be Agent Agnostic. Whether you use Google's Antigravity, Kilo, Claude Code, or Cursor, APC provides the structure they need to succeed.

โš ๏ธ Development Status Disclaimer

Audio Plugin Coder (APC) is currently in active development. APIs may change, features may be incomplete, and bugs should be expected.

Use APC for development and experimentation purposes only until a stable release is announced.

What is Audio Plugin Coder?

Audio Plugin Coder (APC) is a structured, AI-driven workflow system that guides LLM agents through the entire audio plugin development lifecycle.

It enables the creation of VST3 / AU / CLAP plugins using natural language, predefined workflows, and domain-specific skills- without constantly re-explaining context, architecture, or best practices to the AI.

Instead of manually juggling DSP architecture, UI frameworks, build systems, state tracking, and packaging, APC provides a unified framework where AI agents can operate with long-term context, validation, and self-improving knowledge.

โœจ Key Features

  • ๐Ÿค– LLM-Driven Development - Designed to work with Antigravity, Kilo, Claude Code, Cursor, or any coding agent.
  • ๐ŸŽฏ Structured Workflows - Five-phase system: Dream โ†’ Plan โ†’ Design โ†’ Implement โ†’ Ship.
  • ๐ŸŽจ Dual UI Frameworks - Choose Visage (pure C++) or WebView (HTML5 Canvas).
  • ๐Ÿ“Š State Management - Automatic progress tracking, validation, and rollback capabilities.
  • ๐Ÿ”ง Self-Improving - Auto-capture troubleshooting knowledge; the system gets smarter over time.
  • ๐Ÿ—๏ธ Production Ready - JUCE 8 integration with CMake build system.
  • ๐Ÿ“š Comprehensive Skills - Pre-built domain knowledge for DSP, UI design, testing, and packaging.

๐Ÿš€ Quick Start

Prerequisites

  • Windows 11 (macOS/Linux via GitHub Actions)
  • PowerShell 7+
  • Visual Studio 2022 (with C++ development tools)
  • CMake 3.22+
  • Git
  • An LLM coding agent (Claude Code, Kilo, etc.)

Installation

  1. Clone the repository (with submodules):
git clone --recursive https://github.com/Noizefield/audio-plugin-coder.git
cd audio-plugin-coder

Or clone normally and run setup:

git clone https://github.com/Noizefield/audio-plugin-coder.git
cd audio-plugin-coder
.\scripts\setup.ps1
  1. Initialize your LLM agent:

For Kilo:

# Workflows are automatically discovered from .kilocode/workflows/

For Claude Code:

# The agent will discover workflows from .kilocode/workflows/
  1. Create your first plugin:
/dream MyReverb

The AI will guide you through the entire process!

๐Ÿ“– How It Works

The Five-Phase Workflow

๐Ÿ’ญ DREAM (Ideation)
   โ†“ Create creative brief, define parameters
   
๐Ÿ“‹ PLAN (Architecture)  
   โ†“ Design DSP graph, select UI framework
   
๐ŸŽจ DESIGN (GUI)
   โ†“ Create mockups, iterate on visual design
   
๐Ÿ’ป IMPLEMENT (Code)
   โ†“ Build DSP engine, integrate UI
   
๐Ÿš€ SHIP (Package)
   โ†“ Build installers, test in DAWs

Slash Commands

Command Description
/dream [Name] Start new plugin with ideation phase
/plan [Name] Define architecture and select UI framework
/design [Name] Create GUI mockups and visual design
/impl [Name] Implement DSP and UI code
/ship [Name] Package and distribute plugin
/status [Name] Check current progress and state
/resume [Name] Continue development from last phase
/new [Name] Run complete workflow with confirmations

Example Session

You: /dream TapeDelay

AI: Great! Let's define your plugin concept.

    What is the sonic character?
    (e.g., "Warm analog tape delay with wow/flutter")
    
You: Vintage tape echo with analog saturation

AI: Perfect! What are the top 3-5 parameters you want?

You: Delay time, feedback, wow/flutter amount, saturation, mix

AI: โœ… Dream phase complete!
    
    Files created:
    - plugins/TapeDelay/.ideas/creative-brief.md
    - plugins/TapeDelay/.ideas/parameter-spec.md
    - plugins/TapeDelay/status.json
    
    Next step: /plan TapeDelay

๐Ÿ—๏ธ Architecture & Self-Correction

APC uses a unique State Management system (status.json) to track development across phases. This allows you to pause, switch agents, or restart specific phases without losing context.

Directory Structure

audio-plugin-coder/
โ”œโ”€โ”€ .[Agent]/                    # AI agent configuration
โ”‚   โ”œโ”€โ”€ workflows/               # Slash command orchestrators
โ”‚   โ”‚   โ”œโ”€โ”€ dream.md
โ”‚   โ”‚   โ”œโ”€โ”€ plan.md
โ”‚   โ”‚   โ”œโ”€โ”€ design.md
โ”‚   โ”‚   โ”œโ”€โ”€ impl.md
โ”‚   โ”‚   โ””โ”€โ”€ ship.md
โ”‚   โ”œโ”€โ”€ skills/                  # Domain knowledge modules
โ”‚   โ”‚   โ”œโ”€โ”€ skill_ideation/
โ”‚   โ”‚   โ”œโ”€โ”€ skill_planning/
โ”‚   โ”‚   โ”œโ”€โ”€ skill_design/
โ”‚   โ”‚   โ”œโ”€โ”€ skill_implementation/
โ”‚   โ”‚   โ””โ”€โ”€ skill_packaging/
โ”‚   โ”œโ”€โ”€ guides/                  # Reference documentation
โ”‚   โ”‚   โ””โ”€โ”€ state-management-guide.md
โ”‚   โ”œโ”€โ”€ rules/                   # System constraints
โ”‚   โ”‚   โ”œโ”€โ”€ agent.md
โ”‚   โ”‚   โ””โ”€โ”€ file-naming-conventions.md
โ”‚   โ”œโ”€โ”€ troubleshooting/         # Auto-captured issues
โ”‚   โ”‚   โ”œโ”€โ”€ known-issues.yaml
โ”‚   โ”‚   โ””โ”€โ”€ resolutions/
โ”‚   โ””โ”€โ”€ templates/
โ”œโ”€โ”€ docs/                        # Comprehensive documentation
โ”œโ”€โ”€ plugins/                     # Generated plugins
โ”‚   โ””โ”€โ”€ [YourPlugin]/
โ”‚       โ”œโ”€โ”€ .ideas/              # Specs and planning
โ”‚       โ”œโ”€โ”€ Design/              # UI mockups
โ”‚       โ”œโ”€โ”€ Source/              # C++ code
โ”‚       โ””โ”€โ”€ status.json          # State tracking
โ”œโ”€โ”€ scripts/                     # Build automation
โ”‚   โ”œโ”€โ”€ state-management.ps1
โ”‚   โ””โ”€โ”€ build-and-install.ps1
โ””โ”€โ”€ build/                       # Compilation artifacts

How Skills Work

Skills contain domain knowledge (the "how"):

  • Step-by-step instructions
  • Best practices
  • Framework-specific guidance
  • Code generation patterns

Workflows orchestrate skills (the "when"):

  • Prerequisites validation
  • Phase transitions
  • State management
  • Error recovery

Example: The /design workflow checks your UI framework selection (Visage or WebView) from status.json, then loads the appropriate design skill automatically.

๐ŸŽจ UI Framework Options

Visage (Pure C++) - Planned

  • Native JUCE components
  • High performance
  • Full C++ control
  • Custom rendering with visage::Frame

Note: Visage integration is planned but not yet implemented in the current beta version.

WebView (HTML5 Canvas)

  • Modern web technologies
  • Rapid iteration with hot reload
  • Rich component libraries
  • Canvas-based rendering for performance

The AI helps you choose based on your plugin's complexity and requirements during the planning phase.

๐Ÿ”ง State Management

Every plugin has a status.json file tracking:

  • Current development phase
  • UI framework selection
  • Completed milestones
  • Validation checkpoints
  • Error recovery points

Benefits:

  • Resume development any time
  • Validate prerequisites automatically
  • Rollback on errors
  • Track project history

๐Ÿง  Self-Improving Troubleshooting

APC includes an auto-capture system that learns from problems:

  1. AI encounters error โ†’ Searches known issues database
  2. If known โ†’ Applies documented solution immediately
  3. If unknown โ†’ Attempts resolution, tracks attempts
  4. After 3 attempts โ†’ Auto-creates issue entry
  5. When solved โ†’ Documents solution for future use

Location: .kilocode/troubleshooting/

Result: The system gets smarter with every issue encountered!

๐Ÿค Compatible AI Agents

APC works with any LLM-based coding agent that supports:

  • Custom workflows/slash commands
  • File system access
  • PowerShell execution

Tested with:

  • โœ… Claude Code (Anthropic)
  • โœ… Kilo (kilo.ai)
  • Cursor
  • Others welcome!

๐Ÿ› ๏ธ Technology Stack

  • JUCE 8 - Audio plugin framework
  • CMake - Build system
  • PowerShell - Automation scripting
  • JUCE 8 - Audio plugin framework (includes DSP, GUI, etc.)
  • WebView2 - Chromium-based web UI
  • YAML - Knowledge base format
  • Markdown - Documentation and workflows

๐Ÿ“‹ Supported Plugin Formats

Format Windows macOS Linux
VST3 โœ… โœ… โœ…
Standalone โœ… โœ… โœ…
AU โŒ โœ… โŒ
LV2 โŒ โŒ โœ…

CLAP support planned for future release.

๐Ÿ“š Documentation

Comprehensive documentation is available in the docs/ directory:

๐Ÿ”ฎ Roadmap

  • Windows support
  • GitHub Actions CI/CD
  • Comprehensive documentation
  • macOS local build support
  • Linux local build support
  • CLAP format support
  • Preset management system
  • Plugin marketplace integration
  • Real-time collaboration features

๐Ÿ’– Sponsor the Project

I am an independent developer pouring hundreds of hours (and significant API costs) into this project.

Developing a framework that works across different AI agents means constantly testing against paid tiers of Claude, Gemini, and others. I often run out of "Plan" usage just testing a single workflow improvement.

If APC saves you time, helps you learn JUCE, or helps you ship a plugin, please consider supporting the development. It helps cover API costs and accelerates macOS support!

โ˜• Buy Me a Coffee / Sponsor on GitHub

Crypto/Other options TBD

๐Ÿค Contributing & Community

Contributions are welcome! Join our GitHub Discussions to connect with the community.

  • Add Skills: Create new domain knowledge modules
  • Test Platforms: Verify compatibility with different AI agents
  • Improve Docs: Help us improve documentation
  • Share Plugins: Showcase what you've built

See CONTRIBUTING.md for details.

๐Ÿ™ Acknowledgments

  • JUCE Team - For the industry-standard framework.
  • The AI Community - Specifically the meta-prompting pioneers.
  • Tร‚CHES (glittercowboy) - Inspiration for context engineering systems.

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with โค๏ธ (and a lot of tokens) for the audio development community.

Turn your plugin ideas into reality with the power of AI

About

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 8 and powered by a revolutionary 5-phase workflow system.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published