agentcraft 0.0.1 → 0.0.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcraft",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Assign sounds to AI coding agent lifecycle events. Works with Claude Code and OpenCode.",
   "author": { "name": "rohenaz" },
   "keywords": ["sounds", "hooks", "audio", "productivity", "opencode", "claude-code"]

package/README.md

@@ -18,7 +18,7 @@ From any Claude Code session:
 
 **2. Sounds download automatically**
 
-On first launch, AgentCraft clones the [agentcraft-sounds](https://github.com/rohenaz/agentcraft-sounds) library to `~/.agentcraft/sounds/`. No manual setup required.
+On first launch, AgentCraft installs the [agentcraft-sounds](https://github.com/rohenaz/agentcraft-sounds) pack to `~/.agentcraft/packs/rohenaz/agentcraft-sounds/`. No manual setup required.
 
 **3. The dashboard opens at `http://localhost:4040`**
 
@@ -38,11 +38,48 @@ From then on, Claude Code plays your sounds automatically as it works — no das
 claude plugin install agentcraft@rohenaz
 ```
 
+## CLI
+
+The `agentcraft` CLI manages sound packs:
+
+```bash
+npm install -g agentcraft
+# or
+bun install -g agentcraft
+```
+
+```bash
+agentcraft pack install rohenaz/agentcraft-sounds   # install a pack from GitHub
+agentcraft pack list                                # list installed packs
+agentcraft pack update rohenaz/agentcraft-sounds   # update a pack (git pull)
+agentcraft pack update --all                       # update all packs
+agentcraft pack remove rohenaz/agentcraft-sounds   # remove a pack
+```
+
+## 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:
+```bash
+git clone https://github.com/publisher/name ~/.agentcraft/packs/publisher/name
+```
+
+To create your own pack: make a GitHub repo with sound files, share the `publisher/name` slug. That's it — no registry, no manifest required.
+
 ## Prerequisites
 
 - [Bun](https://bun.sh) — runs the web UI
 - [jq](https://jqlang.github.io/jq/) — JSON parsing in the hook script
-- [git](https://git-scm.com) — downloads the sound library on first run
+- [git](https://git-scm.com) — downloads packs on install
 - macOS: `afplay` (built in) · Linux: `paplay` or `aplay`
 
 ## Hooks
@@ -72,20 +109,12 @@ The **UI SFX** dropdown in the header controls ambient sounds that play as you u
 | FF9 | Final Fantasy IX — soft, minimal |
 | OFF | No UI sounds |
 
-## Sound Library
-
-Sounds live at `~/.agentcraft/sounds/`. Any `.mp3`, `.wav`, `.ogg`, or `.m4a` file you drop there appears in the browser automatically. To update the library:
-
-```bash
-git -C ~/.agentcraft/sounds pull
-```
-
 ## Storage
 
 | Path | Contents |
 |------|----------|
 | `~/.agentcraft/assignments.json` | Your sound assignments |
-| `~/.agentcraft/sounds/` | Sound library |
+| `~/.agentcraft/packs/` | Installed sound packs |
 
 ## Managing the Plugin
 

package/bin/agentcraft.js

@@ -1,12 +1,156 @@
 #!/usr/bin/env node
 'use strict';
 
-// AgentCraft CLI — https://github.com/rohenaz/agentcraft
-// Full implementation coming in a future release.
-// Install the Claude Code plugin: claude plugin install agentcraft@rohenaz
+const { execSync, spawnSync } = require('child_process');
+const { existsSync, readdirSync, rmSync, statSync, mkdirSync } = require('fs');
+const { join } = require('path');
+const { homedir } = require('os');
 
-const [,, cmd, ...args] = process.argv;
+const PACKS_DIR = join(homedir(), '.agentcraft', 'packs');
+const [,, cmd, sub, ...rest] = process.argv;
 
-console.log('AgentCraft CLI v0.0.1');
-console.log('Full CLI coming soon. Install the Claude Code plugin:');
-console.log('  claude plugin install agentcraft@rohenaz');
+function ensureDir(p) {
+  mkdirSync(p, { recursive: true });
+}
+
+function parsePackId(arg) {
+  if (!arg || !arg.includes('/')) {
+    console.error(`Error: pack must be "publisher/name", got: ${arg ?? '(nothing)'}`);
+    process.exit(1);
+  }
+  const slash = arg.indexOf('/');
+  const publisher = arg.slice(0, slash);
+  const name = arg.slice(slash + 1);
+  return { publisher, name, id: arg, url: `https://github.com/${publisher}/${name}` };
+}
+
+function getInstalledPacks() {
+  if (!existsSync(PACKS_DIR)) return [];
+  const packs = [];
+  for (const publisher of readdirSync(PACKS_DIR)) {
+    const ppath = join(PACKS_DIR, publisher);
+    try {
+      if (!statSync(ppath).isDirectory()) continue;
+    } catch { continue; }
+    for (const name of readdirSync(ppath)) {
+      try {
+        if (statSync(join(ppath, name)).isDirectory()) packs.push(`${publisher}/${name}`);
+      } catch { continue; }
+    }
+  }
+  return packs;
+}
+
+function packInstall(packArg) {
+  const { publisher, name, url } = parsePackId(packArg);
+  const dest = join(PACKS_DIR, publisher, name);
+  if (existsSync(dest)) {
+    console.log(`Already installed: ${publisher}/${name}`);
+    process.exit(0);
+  }
+  ensureDir(join(PACKS_DIR, publisher));
+  console.log(`Installing ${publisher}/${name} from ${url} ...`);
+  const r = spawnSync('git', ['clone', url, dest], { stdio: 'inherit' });
+  if (r.status !== 0) {
+    console.error(`Failed to install ${publisher}/${name}`);
+    process.exit(1);
+  }
+  console.log(`\nInstalled: ${publisher}/${name}`);
+}
+
+function packRemove(packArg) {
+  const { publisher, name } = parsePackId(packArg);
+  const dest = join(PACKS_DIR, publisher, name);
+  if (!existsSync(dest)) {
+    console.error(`Not installed: ${publisher}/${name}`);
+    process.exit(1);
+  }
+  rmSync(dest, { recursive: true, force: true });
+  console.log(`Removed: ${publisher}/${name}`);
+}
+
+function packUpdate(packArg) {
+  const { publisher, name } = parsePackId(packArg);
+  const dest = join(PACKS_DIR, publisher, name);
+  if (!existsSync(dest)) {
+    console.error(`Not installed: ${publisher}/${name}. Run: agentcraft pack install ${publisher}/${name}`);
+    process.exit(1);
+  }
+  console.log(`Updating ${publisher}/${name} ...`);
+  spawnSync('git', ['-C', dest, 'pull'], { stdio: 'inherit' });
+}
+
+function packList() {
+  const packs = getInstalledPacks();
+  if (!packs.length) {
+    console.log('No packs installed.');
+    console.log('\nInstall the official pack:');
+    console.log('  agentcraft pack install rohenaz/agentcraft-sounds');
+  } else {
+    console.log('Installed packs:');
+    for (const p of packs) console.log(`  ${p}`);
+  }
+}
+
+function showHelp() {
+  console.log(`
+AgentCraft CLI — assign sounds to AI agent lifecycle events
+
+Usage:
+  agentcraft pack install <publisher/name>     Install a sound pack from GitHub
+  agentcraft pack remove  <publisher/name>     Remove an installed pack
+  agentcraft pack update  <publisher/name>     Update a pack (git pull)
+  agentcraft pack update  --all                Update all installed packs
+  agentcraft pack list                         List installed packs
+  agentcraft start                             Launch the dashboard (port 4040)
+
+Examples:
+  agentcraft pack install rohenaz/agentcraft-sounds
+  agentcraft pack update --all
+  agentcraft pack list
+
+Packs are stored at: ~/.agentcraft/packs/<publisher>/<name>/
+Any git repo cloned there is automatically discovered by the dashboard.
+
+Install the Claude Code plugin:
+  claude plugin install agentcraft@rohenaz
+`);
+}
+
+if (cmd === 'pack') {
+  if (sub === 'install') {
+    if (!rest[0]) { console.error('Usage: agentcraft pack install <publisher/name>'); process.exit(1); }
+    packInstall(rest[0]);
+  } else if (sub === 'remove') {
+    if (!rest[0]) { console.error('Usage: agentcraft pack remove <publisher/name>'); process.exit(1); }
+    packRemove(rest[0]);
+  } else if (sub === 'update') {
+    if (rest[0] === '--all') {
+      const packs = getInstalledPacks();
+      if (!packs.length) { console.log('No packs installed.'); process.exit(0); }
+      for (const p of packs) packUpdate(p);
+    } else {
+      if (!rest[0]) { console.error('Usage: agentcraft pack update <publisher/name> | --all'); process.exit(1); }
+      packUpdate(rest[0]);
+    }
+  } else if (sub === 'list') {
+    packList();
+  } else {
+    console.error(`Unknown pack subcommand: ${sub ?? '(none)'}`);
+    console.error('Usage: agentcraft pack <install|remove|update|list>');
+    process.exit(1);
+  }
+} else if (cmd === 'start') {
+  const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT;
+  if (!pluginRoot) {
+    console.error('CLAUDE_PLUGIN_ROOT not set. This command is intended to run from the Claude Code plugin context.');
+    process.exit(1);
+  }
+  execSync(`cd "${pluginRoot}/web" && bun dev --port 4040`, { stdio: 'inherit' });
+} else if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+  showHelp();
+} else {
+  console.error(`Unknown command: ${cmd}`);
+  showHelp();
+  process.exit(1);
+}

package/commands/agentcraft.md

@@ -1,5 +1,5 @@
 ---
-allowed-tools: Bash(lsof:*), Bash(open:*), Bash(bun:*), Bash(curl:*), Bash(git:*), Bash(ls:*), Bash(mkdir:*)
+allowed-tools: Bash(lsof:*), Bash(open:*), Bash(bun:*), Bash(curl:*), Bash(git:*), Bash(ls:*), Bash(mkdir:*), Bash(agentcraft:*)
 description: Open the AgentCraft sound assignment dashboard. Launches web UI on port 4040.
 argument-hint: "[--stop] Stop the AgentCraft server"
 ---
@@ -12,14 +12,15 @@ kill $(lsof -ti:4040) 2>/dev/null
 echo "AgentCraft server stopped."
 ```
 
-Otherwise, ensure the sound library is present. Check if ~/.agentcraft/sounds exists and has files:
+Check if the official sound pack is installed:
 ```bash
-ls ~/.agentcraft/sounds 2>/dev/null | head -1
+ls ~/.agentcraft/packs/rohenaz/agentcraft-sounds 2>/dev/null | head -1
 ```
 
-If that returned nothing (empty or missing), clone the sound library:
+If that returned nothing (empty or missing), install it:
 ```bash
-git clone https://github.com/rohenaz/agentcraft-sounds ~/.agentcraft/sounds
+agentcraft pack install rohenaz/agentcraft-sounds 2>/dev/null || \
+  git clone https://github.com/rohenaz/agentcraft-sounds ~/.agentcraft/packs/rohenaz/agentcraft-sounds
 ```
 
 Check if server is already running: