configure

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."