Patchbay — Plugin para Músicos
colfitt/patchbay-plugin
Inventário de gear, pesquisa de tons e design de patches para músicos
Ver no GitHubPlugin Claude Code que transforma uma pasta de gear em base de conhecimento interativa. Permite inventariar equipamentos, pesquisar tons de músicas famosas, desenhar patches com o que você já possui e gerenciar síndrome de aquisição de gear (GAS) de forma honesta.
Instalação
npx convez-ai colfitt/patchbay-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Replicar o som de uma música usando equipamento que você já tem
- Documentar e organizar inventário de pedais, amplificadores e efeitos
- Pesquisar qual gear foi usado em gravações famosas
- Desenhar signal chains e patches com notas de técnica e posições de knob
Veredito

Ferramenta bem pensada para um nicho específico (músicos), com lógica sólida de prevenção de compras impulsivas e pesquisa de tons. Implementação madura (v1.0 + v2.0 shipped, testes passando), mas o escopo ainda é bastante técnico e requer familiaridade com folders de gear e Claude Code.
README
A tradução para o português deste README ainda está na fila.
patchbay
A Claude Code plugin for musicians. Point it at your gear folder and it adds skills to inventory, research, design patches, and chase the tones behind the songs you love.
hello, ARLO here, local clanker and certified gear-knower. is your project file sitting open for ᶠᵒᵘʳ ᵐᵒⁿᵗʰˢ? are you spending $400 on a pedal you ALREADY OWN A SUBSTITUTE FOR? is your bridge constantly clawing at your DAW driving you c r a z y? think there's no answer? you're so stupid! there is! patchbay. finally, there is an elegant, comfortable plugin for musicians. [songwriter awkwardly stares at unfinished lyric and falls the heck off chair] i couldn't hear ᵃⁿʸ ᵐᵒʳᵉ ʷʰᶦⁿᶦⁿᵍ! is your gear ᵒⁿᵉˡᵉᵍᵍᵉᵈ? is it boutique, or an in-between? that doesn't matter! cause patchbay reads ANY folder! you'll be smitten! so come on down to
~/patchbay. we're the hoooooooommee of the original gear knowledge base. ᵐᵉᵉᵉᵉᵉᵉᵉᵉᵒᵒᵒᵒᵒᵒᵒᵒᵒᵒᵒᵒʷ
How to use it (try these)
# Chase the tone behind a song you love
"Liner notes on Creep by Radiohead"
"What gear was used on Idioteque"
"Get the sound of Plug In Baby"
# Design a patch using gear you already own
"Dial in Creep by Radiohead"
"Dial in my Big Muff for the bridge in Plug In Baby"
"/dial-in Black Hole Sun"
# Turn a manual PDF into a citation-hover-ready knowledge store
patchbay ingest "Boss BF-3"
# Research a piece of gear across the web (tiered, cheap-by-default)
patchbay research "Strymon BigSky"
patchbay research --review-failures # interactive escalation loop
patchbay research --citations "Boss BF-3" # surface multi-source URLs
patchbay research --verify "Boss BF-3" https://example.com/article
Most skills activate conversationally — just say what you want to do.
Flag-driven commands (patchbay ingest, patchbay research) run in your
terminal.
GAS mode (Gear Acquisition Syndrome) is off by default — patchbay leans on substitution from what you already own. Flip it on for honest acquisition options, including funded swaps from a sell list.
Shipped
| Skill | What it does | Milestone |
|---|---|---|
patchbay:tone-chase | Chase the tone behind a song or artist → SongProfile.md | v1.0 |
patchbay:dialed-in | Design or recall a patch → knob positions + signal chain + technique notes | v1.0 |
patchbay:ingest | Turn a gear-manual PDF into a schema-valid, citation-hover-ready chunks.jsonl | v2.0 |
patchbay:research | Multi-source web ingest (Equipboard, Reddit, articles, YouTube) with tiered fetch | v2.0 |
Status: v1.0 + v2.0 shipped (2026-05-18). 138/138 tests green, 24/24
v2.0 requirements satisfied. Full log in
.planning/MILESTONES.md.
Next up (v3.0)
In priority order — top is what we're building next.
- 🎯
patchbay:finish-a-damn-song— conversational pre-production with ARLO. Finish songs with the gear you own. (design committed → spec) patchbay:midi— generate.mid/.syxor send real-time MIDIpatchbay:soundcheck— first-time setup; detect/scaffold folder conventionpatchbay:add-gear— structured gear onboarding- Hover-citation UX — deep-link every sentence to its source
- CITATION-02 — primary-source independence (fixes v2.0 same-class under-count)
- Multi-gear tone-graph queries — cross-gear recommendations
patchbay:purge— review inventory for sell candidates
Full detail + longer arc in .planning/ROADMAP.md.
How it works
Patchbay reads whatever folder structure you have. Works best with a
Pedalxly-style layout (Gear/<Brand Item>/,
Software/<Brand Product>/, Songs/<Artist>/<song>/), adapts to flat or
custom layouts via a per-project patchbay.yml.
Every gear-related skill writes into a unified per-gear knowledge store
at <gear_root>/<Brand Item>/knowledge/chunks.jsonl — append-only JSONL,
schema-validated, citation-ready.
License
[TBD]