Skip to content
OpenRootdevPublic

About

A sound effects workspace for AI agents: your agent makes the sounds, you hear and shape them in a local Studio, then export WAVs, typing tracks or a whole mixed soundtrack.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

sfx-tool logo

sfx-tool

A sound effects workspace for AI agents: your agent makes the sounds, you hear and shape them.
Ask for a sound in plain words, hear it in the Studio a second later, and nudge it by ear until it is right. Everything runs on your computer.

English · Español · Deutsch · Français · 日本語 · 简体中文 · Português

The sfx-tool Studio: moving the pitch and length sliders reshapes the waveform and spectrum, then eight variations of a sound

Download  ·  Get started  ·  Agent skill

Works with
 Claude Code  ·   Codex  ·   Node.js  ·   FFmpeg

What it does

Your agent writes each sound as a small recipe file, and the Studio plays it the moment the file changes. You listen, move a slider or pick one of eight variations, and the agent sees your changes too. When it sounds right, export a WAV or a whole typing track for your video.

  • Describe a sound ("softer", "more wooden", "like a real keyboard") and your agent builds it; you never write audio code.
  • Every change is live: waveform, spectrum and loudness checks update as you or the agent edit.
  • Made on your computer, with no account, API key or credit needed. It starts with 34 example sounds (key taps, knocks, pops, chimes) to build from.
  • Beyond single sounds, a second skill teaches your agent sound design for whole videos: music, timing, silence and the final mix. It can also study a finished video, or one whose sound you like, and score yours to match.

Get started

  1. Install Node.js 18 or newer.
  2. Copy the skill/ folder into your agent's skills folder (for Claude Code: ~/.claude/skills/sfx-tool). For whole soundtracks, copy skills/sound-design/ there too.
  3. Open a terminal in your project's folder and run the command below. It creates an sfx/ folder and opens the Studio in your browser.
  4. Ask your agent in plain words, for example "Make a soft, wooden click for each typed letter, and a gentle chime when the line is done." The new sounds appear in the Studio, ready to tweak.
npx github:OpenRootdev/sfx-tool studio --open

What you need

  • Node.js 18 or newer. Nothing else to install.
  • An AI agent that can use skills and run commands, such as Claude Code or Codex. The Studio also works on its own.
  • A browser for the Studio.

What's inside

  • skill/SKILL.md · How your agent turns a description into a sound, and how it works with you in the Studio.
  • skills/sound-design/ · Sound design for whole videos: what makes sound feel professional, and how to get there in each kind of video.
  • studio/ · The page where you hear and shape the sounds.
  • bin/sfx-tool.js · The command your agent (or you) runs: make sounds, variations and typing tracks, mix a soundtrack, read a song's tempo and key, or study a video.
  • src/ · The sound models and the example sounds.

Preview media lives on the assets branch and translations on translations, so main holds only the tool.


MIT licence · OpenRootdev

About

A sound effects workspace for AI agents: your agent makes the sounds, you hear and shape them in a local Studio, then export WAVs, typing tracks or a whole mixed soundtrack.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages