agentcraft

AgentCraft

Assign sounds to your AI coding agent's lifecycle events. Configure everything through an SC2-inspired dashboard — drag sounds onto hook slots, pick a UI theme, and hear your agents come alive.

Works with Claude Code, OpenCode, and Pi.

How It Works

1. Run the skill

From any Claude Code session:

/agentcraft

2. Sounds download automatically

On first launch, AgentCraft installs the agentcraft-sounds pack to ~/.agentcraft/packs/rohenaz/agentcraft-sounds/. No manual setup required.

3. The dashboard opens at http://localhost:4040

A local web UI starts in the background. It stays running between sessions so subsequent /agentcraft calls open instantly.

4. Assign sounds to hook points and skill calls

• AGENTS tab — Expand GLOBAL OVERRIDE or any agent row. Click a hook slot (SESSION START, STOP, TOOL FAILURE, etc.) to enter select mode, then click any sound in the browser to assign it. Or drag a sound card directly onto a slot.
• SKILLS tab — Assign sounds to individual skill invocations. Each skill has an ON INVOKE and ON COMPLETE slot.
• Hit ESTABLISH UPLINK to save.

From then on, Claude Code plays your sounds automatically as it works — no dashboard needed.

Install

Claude Code

claude plugin install agentcraft@rohenaz

Pi

pi install git:github.com/rohenaz/agentcraft

Or copy the extension file manually:

cp pi-extension.ts ~/.pi/agent/extensions/agentcraft.ts

Then from any pi session: /agentcraft to open the dashboard.

OpenCode

cp opencode.ts ~/.config/opencode/plugins/agentcraft.ts

CLI

The agentcraft CLI manages sound packs:

bun install -g agentcraft

agentcraft init                                    # first-time setup
agentcraft add rohenaz/agentcraft-sounds           # install a pack from GitHub
agentcraft list                                    # list installed packs
agentcraft update rohenaz/agentcraft-sounds        # update a pack (git pull)
agentcraft update                                  # update all packs
agentcraft remove rohenaz/agentcraft-sounds        # remove a pack
agentcraft init my-sounds                          # scaffold a new pack repo

Sound Packs

Packs live at ~/.agentcraft/packs/<publisher>/<name>/. Each pack is a plain git repo — installing is just a clone, updating is just a pull.

~/.agentcraft/packs/
  rohenaz/
    agentcraft-sounds/     ← official pack
  you/
    custom-pack/           ← any git repo cloned here works automatically

Manual install works identically to the CLI:

git clone https://github.com/publisher/name ~/.agentcraft/packs/publisher/name

Pack Structure

Sounds are organized into directories — the dashboard reads depth dynamically:

my-sounds/
  sc2/                          ← group tab
    terran/                     ← sub-tab
      session-start/            ← subcategory
        scv-ready.mp3
      task-complete/
        marine-salute.mp3
  ui/                           ← optional: dashboard UI theme sounds
    sc2/
      click.mp3
      hover.mp3
      confirm.mp3
      error.mp3
      pageChange.mp3

Any layout works — flat, mood-organized, game-organized. File names become display names in the browser (scv-ready.mp3 → "Scv Ready"). Supported formats: .mp3, .wav, .ogg, .m4a.

Add an optional pack.json at the root for display metadata:

{
  "name": "my-sounds",
  "publisher": "your-github-username",
  "version": "1.0.0",
  "description": "Short description shown in the dashboard",
  "types": ["sounds", "ui"]
}

sounds.sh Themes

sounds.sh is a curated sound library built for Claude Code. AgentCraft integrates it directly — open the PACKS tab and scroll to the SOUNDS.SH section to browse and install any of its themed packs (Minecraft, Age of Empires 2, The Sims, Resident Evil, and more).

Installing a sounds.sh theme downloads the MP3s locally and wires up hook assignments automatically. No account or API key needed.

Creating a Pack

Fastest path — scaffold with the CLI:

agentcraft init my-sounds
cd my-sounds
# drop your audio files in, then push to GitHub

Or ask your agent. From any Claude Code session, say something like:

"Help me create a sound pack" or "scaffold a new agentcraft pack called my-sounds"

The agent will invoke the agentcraft:packs skill and walk you through the whole process — directory structure, pack.json, and publishing.

Publishing

1. Push the repo to GitHub
2. Add the agentcraft-pack topic (repo Settings → Topics)
3. Share the install command: agentcraft add your-username/your-repo

The community registry picks up newly tagged repos every 6 hours. No approval required.

Prerequisites