From 3932e9b2b77917f49bba53ff0f8e226cb4879804 Mon Sep 17 00:00:00 2001 From: Tobias Gesellchen Date: Mon, 18 May 2026 20:11:37 +0200 Subject: [PATCH] docs: Update CLAUDE.md with current project structure and binaries - Documents soundtouch-web and soundtouch-backup binaries - Updates build targets and Go version requirements - Improves session pickup documentation clarity - Reorganizes project structure documentation --- CLAUDE.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 5bc149d..f5407e6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,20 +12,20 @@ speakers usable without it. **Module:** `github.com/gesellix/bose-soundtouch` -Two binaries: +Key binaries: - `soundtouch-cli` — command-line control of one or more speakers (status, play, presets, groups, migration, …). - `soundtouch-service` — local replacement for `streaming.bose.com` and the `bmx` services, default port `8000`. +- `soundtouch-web` — Web UI for Radio browsing and device control. +- `soundtouch-backup` — Helper for on-device backup and restore. -Per-session pickup notes live in two local files at the repo root: +Per-session pickup notes live in two local files at the repo root (they are `.gitignore`d and only exist if created during a session): - `NEXT.md` — current "pick up here" log of open items. - `DONE.md` — archive of recently resolved items. -Both are `.gitignore`d on purpose; they don't follow the repo. - ## How a new session should start 1. Read this file. @@ -40,7 +40,10 @@ Both are `.gitignore`d on purpose; they don't follow the repo. ```bash # Build -make build # CLI + service for current platform +make build # All binaries +make build-cli # Just CLI +make build-service # Just service +make build-web # Just web UI make build-all # Cross-platform builds (Linux, macOS, Windows) make install # Install to $GOPATH/bin @@ -109,13 +112,14 @@ pkg/ service/ bmx/ # Bose Media eXchange service emulation marge/ # Device-management service emulation - handlers/ # HTTP request handlers + handlers/ # HTTP request handlers (pkg/service/handlers/) proxy/ # HTTP proxy with request recording datastore/ # Persistent device data storage certmanager/ # TLS certificate management setup/ # Device migration and configuration spotify/ # Spotify integration stockholm/ # Optional Stockholm frontend bridge + soundtouchweb/ # SoundTouch Web UI service logic examples/ # Feature demonstration programs docs/ # Long-form analysis, guides, troubleshooting .junie/ # Communication-style guidelines (see below) @@ -123,7 +127,7 @@ docs/ # Long-form analysis, guides, troubleshooting ## Key technologies -- **Go 1.26+** +- **Go 1.26.3+** - **chi v5** — HTTP router - **gorilla/websocket** — WebSocket for real-time events - **hashicorp/mdns** — mDNS device discovery