Skip to content
For agents and developers

Give your coding agent a sound library.

The sb CLI and its skill let agents search, tweak, render and download sounds, and submit new ones that earn you credits.

Quick start · macOS and Linux
$ curl -fsSL https://sonicbricks.com/pub/cli/install.sh | sh ✓ Verified the release signature. ✓ Installed sb in ~/.local/bin/sb

Then ask: “Find a soft confirm click and add it to the Save button.”

1

Install

One script for macOS and Linux (arm64 and x64). It downloads the archive for your platform, checks it against SHA256SUMS, verifies the release signature when OpenSSL 3 is available, and stops if either check fails. Prefer to read it first? Open install.sh.

shell
$ curl -fsSL https://sonicbricks.com/pub/cli/install.sh | sh
2

Sign in

sb login opens your browser to approve this machine. Check that the key fingerprint on the page matches your terminal, then approve. The private key stays in your OS keychain; SonicBricks only ever sees the public half.

On a server or a machine without a browser, use sb login --device and enter the code on any device.

browser approval
$ sb login Approve this device in your browser (key fingerprint cb37:4e8d:8a0d:2ea4): https://sonicbricks.com/cli/authorize?… ✓ Signed in to https://sonicbricks.com as @you
no browser
$ sb login --device On any device, open https://sonicbricks.com/cli/device and enter the code BCDF-GHJK
3

Install the skill

The skill teaches your agent to search before authoring, pick presets, tweak parameters, read exit codes and write files into your project. It ships inside sb, so it always matches your CLI.

shell
$ sb skill install ✓ Installed the sonicbricks skill in ~/.claude/skills/sonicbricks.
4

Search and get

Every command takes --json and returns exit codes your agent can branch on. sb get downloads the MP3 of a preset, or renders a WAV locally when you pass parameters, a seed or a duration.

Guests can preview ten sounds before signing in. Sign in for unlimited free previews. Downloads and recipe fetches use your daily quota (20 and 30). Past that, each costs 1 credit, charged automatically. Re-downloading the same revision and render is always free and uses no quota; recipe re-fetches are free within 30 days.

search
$ sb search "soft click" 7HK2A9QX3M@3 Soft UI Confirm Click one-shot @sonicbricks ♥312
get a preset, or render a tweak
$ sb get 7HK2A9QX3M --preset crisp -o click.mp3 ✓ Saved click.mp3 (7HK2A9QX3M@3 render 1, free quota) $ sb get 7HK2A9QX3M --preset crisp --param decay=0.08 --seed 4 -o click.wav ✓ Rendered click.wav (0.14 s, engine 1.0.1)
5

Author a sound

Ask your agent to write a new sound. The CLI scaffolds it and runs the same checks the server runs, in the same sandbox and engine, so a sound that passes locally passes the quality gates.

sb new
Scaffold a sound with presets and parameters
sb lint
Every check the validator runs: policy, renders, determinism, extremes, quality gates
sb analyze
Loudness, peak, tail and DC per preset, and a spectrogram
sb preview
Play every preset in your browser; reloads on save
sb analyze
$ sb analyze click.ts --png click.png render seconds LUFS dBTP RMS dB tail dB (defaults) 0.35 — -1.6 -19.3 — crisp 0.35 — -0.4 -18.3 — error[audio.peak] [crisp]: true peak -0.40 dBTP is above the limit — measured -0.40, limit -0.90 dBTP hint: Lower the gain of the loudest layer or reduce resonance.
6

Submit

Before your first submission, you accept the contributor terms yourself; your agent can't accept them for you. Each submission runs in a sandbox: renders, quality checks, a duplicate check and text moderation. Follow it in your account.

QueuedValidatingValidatedAccepted
once, by you
$ sb terms Contributor terms 2026-10: https://sonicbricks.com/contributor-terms $ sb terms accept 2026-10
by your agent
$ sb submit click.ts --wait Submitted 01JD8Q…; waiting for validation… ✓ accepted: published 7HK2A9QX3M@1 · use('7HK2A9QX3M@1')
7

Earn credits, meet the bar

When people use your sound, or build a new sound on it, you earn credits. Earned credits expire after 13 months.

Credits
New account
+50
Your sound is accepted
+5
Someone uses your sound
+1
A new sound builds on yours
+10
Featured by SonicBricks
+50
Download beyond quota
−1

Operators set these values; they may change.

Quality bar
  • Renders in the sandbox, every preset
  • Peak below −0.9 dBTP, even at parameter extremes
  • Not a duplicate of an existing sound
  • Clear names, description and decomposition
  • No network, file or process access in code

Ready when your agent is.

New accounts start with 50 free credits.