/configure

name: configure
description: Sets up or edits the plugin configuration file interactively. Use on first-time setup, when config is missing, or when the user wants to change settings.
argument-hint: "[setup | edit | show | validate | reset]"
model: sonnet
effort: low
allowed-tools:
  - Read
  - Write
  - Bash
  - AskUserQuestion
  - Glob

Your Task

**Input**: $ARGUMENTS

Route based on argument:

• `setup` or no argument → Interactive first-time setup
• `edit` → Edit specific settings
• `show` → Display current configuration
• `validate` → Check config for issues
• `reset` → Delete config and start fresh

---

Plugin Configuration Skill

You help users set up and manage their `~/.bitwize-music/config.yaml` configuration.

Config Location

~/.bitwize-music/config.yaml

Commands

`/configure` or `/configure setup`

Interactive first-time setup. Guide user through creating their config.

**Steps:**

1. Check if `~/.bitwize-music/config.yaml` exists 2. If exists, ask if they want to overwrite or edit instead 3. If creating new:

• Create `~/.bitwize-music/` directory if needed
• Ask for each required setting interactively
• Write the config file
• Validate the result

**Required settings to ask:** 1. `artist.name` - "What's your artist/project name?" 2. `paths.content_root` - "Where should albums and projects be stored? (e.g., ~/music-projects)" 3. `paths.audio_root` - "Where should mastered audio files go? (e.g., ~/music-projects/audio)" 4. `paths.documents_root` - "Where should research documents/PDFs go? (e.g., ~/music-projects/documents)"

**Optional settings:** 5. `artist.genres` - "What are your primary genres? (comma-separated, or skip)" 6. `urls.soundcloud` - "SoundCloud profile URL? (or skip)"

**Step 5: Overrides Directory (Optional)**

Ask: > You can optionally provide a path to a directory containing override files. > This is where you can customize workflows and skills without plugin update conflicts. > > Override files you can create: > - CLAUDE.md (custom workflow instructions) > - pronunciation-guide.md (artist names, character names) > - explicit-words.md (custom explicit word list) > > Default: ~/music-projects/overrides > > Enter path (or press Enter to use default):

If user provides path:

• Add to config: `paths.overrides: "[user-path]"`

If user presses Enter (accepts default):

• Add to config: `paths.overrides: "~/music-projects/overrides"`
• Tell user: "Note: Directory doesn't need to exist yet. Create override files when you want to customize."

**Step 6: Album Ideas File (Optional)**

Ask: > You can optionally provide a path to a file for tracking album ideas. > This is managed by the /bitwize-music:album-ideas skill for brainstorming and planning. > > Default: ~/music-projects/IDEAS.md > > Enter path (or press Enter to use default):

If user provides path:

• Add to config: `paths.ideas_file: "[user-path]"`

If user presses Enter (accepts default):

• Add to config: `paths.ideas_file: "~/music-projects/IDEAS.md"`
• Tell user: "Note: File doesn't need to exist yet. The album-ideas skill creates it when first used."

**Example interaction:**

Let's set up your bitwize-music configuration.

What's your artist/project name?
> Neon Circuits

Where should albums and projects be stored?
(This is where your album folders, lyrics, and research will live)
> ~/music-projects

Where should mastered audio files go?
> ~/music-projects/audio

Where should research documents/PDFs go?
> ~/music-projects/documents

What are your primary genres? (comma-separated, or press Enter to skip)
> electronic, synthwave

SoundCloud profile URL? (or press Enter to skip)
> https://soundcloud.com/neon-circuits

Overrides directory path? (press Enter for default: ~/music-projects/overrides)
> [Enter]

Album ideas file path? (press Enter for default: ~/music-projects/IDEAS.md)
> [Enter]

Creating config at ~/.bitwize-music/config.yaml...

✓ Configuration saved!

Your settings:
  Artist: Neon Circuits
  Content: ~/music-projects
  Audio: ~/music-projects/audio
  Documents: ~/music-projects/documents
  Genres: electronic, synthwave
  SoundCloud: https://soundcloud.com/neon-circuits
  Overrides: ~/music-projects/overrides (will be used if created)
  Ideas File: ~/music-projects/IDEAS.md (will be created when first used)

You're ready to start creating albums!

`/configure edit`

Edit specific settings without recreating the whole config.

**Steps:** 1. Read existing config 2. Show current values 3. Ask what they want to change 4. Update just that setting 5. Validate and save

**Example:**

Current configuration:

  artist.name: Neon Circuits
  paths.content_root: ~/music-projects
  paths.audio_root: ~/music-projects/audio
  paths.documents_root: ~/music-projects/documents
  artist.genres: [electronic, synthwave]
  urls.soundcloud: https://soundcloud.com/neon-circuits

What would you like to change?

`/configure show`

Display the current configuration in a readable format.

**Steps:** 1. Read `~/.bitwize-music/config.yaml` 2. Display all settings in a formatted table 3. Note any missing required settings

**Example output:**

bitwize-music Configuration
Location: ~/.bitwize-music/config.yaml

┌─────────────────────┬────────────────────────────────────┐
│ Setting             │ Value                              │
├─────────────────────┼────────────────────────────────────┤
│ artist.name         │ Neon Circuits                      │
│ artist.genres       │ electronic, synthwave              │
│ paths.content_root  │ ~/music-projects                   │
│ paths.audio_root    │ ~/music-projects/audio             │
│ paths.documents_root│ ~/music-projects/documents         │
│ paths.overrides     │ ~/music-projects/overrides         │
│ paths.ideas_file    │ ~/music-projects/IDEAS.md          │
│ urls.soundcloud     │ https://soundcloud.com/neon-circuits│
│ generation.service  │ suno                               │
└────────────────────