explaingit

wundercorp/agent-midi

Analysis updated 2026-05-18

3SwiftAudience · developerComplexity · 3/5Setup · moderate

TLDR

A macOS virtual MIDI keyboard that triggers actions in AI coding tools like Codex, Claude Code, and Cursor from programmable pads.

Mindmap

mindmap
  root((Agent MIDI))
    What it does
      Virtual MIDI keyboard
      Trigger coding agent actions
      Runs standalone or embedded
    Tech stack
      Swift
      CoreMIDI
      SwiftUI
    Use cases
      Control Claude Code
      Control Codex CLI
      Launch editors
    Customization
      JSON layouts
      JSON skins
      Visual inspector

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Map physical or on-screen pads to submit, approve, or cancel actions inside Claude Code or Codex.

USE CASE 2

Trigger opening a project workspace in VS Code, Cursor, Zed, or Xcode with one button press.

USE CASE 3

Embed the deck view inside your own SwiftUI IDE and handle its commands yourself.

USE CASE 4

Share custom JSON layouts and skins with teammates who use the same coding agent workflow.

What is it built with?

SwiftSwiftUICoreMIDI

How does it compare?

wundercorp/agent-midiabdullahselek/swiftpusherbartosk97/dead-process-mate
Stars333
LanguageSwiftSwiftSwift
Last pushed2026-06-24
MaintenanceActive
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS and building with Swift Package Manager or the bundled install script.

In plain English

Agent MIDI is a macOS app that turns a virtual MIDI keyboard into a control panel for AI coding assistants. It runs as its own standalone program, and it can also be embedded inside another Swift based app, such as the BuilderStudio IDE mentioned in the README. Once running, it shows up in any MIDI aware software on the Mac as a virtual instrument named Agent MIDI. The idea is to give a physical or on screen keyboard style interface to actions you would normally type, like submitting a task to Codex, approving a change in Claude Code, running a build, or opening a project in an editor such as Visual Studio Code, Cursor, Zed, or Xcode. Each key or pad on the deck can be mapped to a MIDI note, a control change, or a program change, and a built in visual inspector lets you edit what every single control does without writing code. Layouts and visual skins are stored as JSON files in a folder under the user's Application Support directory, so people can create and share their own custom button arrangements and color themes. A layout controls the grid size, where each control sits, what MIDI message it sends, and what command it runs, while a skin controls colors, borders, and spacing. Under the hood, Agent MIDI talks to other software in three ways: standard CoreMIDI messages that any digital audio workstation or automation tool can read, command line adapters built specifically for coding agents and code editors, and a macOS system notification that broadcasts the same event as JSON so other native Mac apps can listen in. A host app can embed the deck view directly and supply its own handler for these commands. The project is written entirely in native Swift and ships as a reusable Swift package called AgentMIDIKit, along with an installer script that copies the finished app into the user's Applications folder. It is aimed at developers who use multiple AI coding tools side by side and want a fast, tactile way to trigger actions in whichever tool has focus.

Copy-paste prompts

Prompt 1
Help me design a JSON layout file for Agent MIDI that maps 8 pads to Claude Code approve, cancel, and build actions.
Prompt 2
Explain how CoreMIDI virtual sources work on macOS and how an app like Agent MIDI creates one.
Prompt 3
Show me how to embed a custom SwiftUI view like AgentMIDIDeckView inside my own macOS app.
Prompt 4
Write a Swift adapter that listens for the com.wundercorp.agentmidi.event distributed notification.

Frequently asked questions

What is agent-midi?

A macOS virtual MIDI keyboard that triggers actions in AI coding tools like Codex, Claude Code, and Cursor from programmable pads.

What language is agent-midi written in?

Mainly Swift. The stack also includes Swift, SwiftUI, CoreMIDI.

How hard is agent-midi to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is agent-midi for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.