docs: handoff + checklist — /Volumes is hidden in Finder; open-over-ssh shows nothing

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-15 22:53:54 -04:00
parent 0377aa3a0b
commit 200de3d0b4
2 changed files with 5 additions and 3 deletions
@@ -58,7 +58,7 @@ Seth asked to "mount tank on the mac as a drive". Shipped `scripts/tank-automoun
 - [x] `run.sh` runs it after `setup.sh`
 - [x] `docs/manual-checklist.md`: tank Favorite + reboot check; Gitea key -> `id_ed25519_homelab`; samples step now uses `/Volumes/tank`
 - [x] DECISIONS.md + CLAUDE.md updated; committed + pushed
- [x] Finder window opened on `/Volumes/tank` for Seth
+- [x] ~~Finder window opened on `/Volumes/tank` for Seth~~ — `open` over ssh did nothing visible; Seth given the Cmd+Shift+G path instead
 ### Files Modified
@@ -80,7 +80,7 @@ Seth asked to "mount tank on the mac as a drive". Shipped `scripts/tank-automoun
 ### Immediate Next Steps
 1. After Seth's next reboot: `ssh mac 'mount | grep auto_smb'` must show the `/Volumes/tank` trigger. If `/Volumes/tank` vanished (boot-time /Volumes cleanup), switch the map to `/tank` via `/etc/synthetic.conf` (`tank` bare line) — needs another reboot.
-2. Seth: drag `/Volumes/tank` to Finder Favorites (checklist). Ask whether the folder-not-drive result is acceptable or he wants the Locations icon (then: Finder Connect-to-Server + Login Item, documented as rejected-for-now in DECISIONS).
+2. Seth: Cmd+Shift+G -> `/Volumes/tank`, drag `tank` from the window title into Favorites (checklist). He was told this at 22:40; not yet confirmed done. Ask whether the folder-not-drive result is acceptable or he wants the Locations icon (then: Finder Connect-to-Server + Login Item, documented as rejected-for-now in DECISIONS).
 3. Carried: `authorize-mac-key.sh` rerun for bedroom/thinkcentre/seth-pi/pinail/openclaw2; `bedroom`=root confirmation; kitty relaunch; Ableton install then `run.sh --no-tank`; audio interface test.
 ### Blockers/Open Questions
@@ -107,6 +107,8 @@ Seth asked to "mount tank on the mac as a drive". Shipped `scripts/tank-automoun
 ### Potential Gotchas
 - `/Volumes` has the `UF_HIDDEN` flag on every Mac — Finder never shows it when browsing Macintosh HD, and `/System/Volumes` (APFS Data/Preboot/VM) is unrelated. Seth hit exactly this ("I don't even see a /Volumes folder"). Path in: Cmd+Shift+G -> `/Volumes/tank`; in kitty `ls /Volumes/tank`.
 - `open /Volumes/tank` over ssh returned success but no Finder window appeared for Seth. Don't use `open` from ssh as a "show it to Seth" signal; tell him the path instead.
 - The Ableton Live 12 Trial Installer DMG was mounted at `/Volumes/Ableton Live 12 Trial Installer` during this session — Seth is mid-install; don't unmount/eject volumes wholesale.
 - `mount | grep tank` shows TWO lines (autofs trigger + smbfs) when mounted; only the trigger when idle. Both are normal.
 - `sed -i ""` (BSD form) is what works on the Mac even with GNU sed on PATH via gnubin — check `which sed` before scripting sed there.
@@ -30,7 +30,7 @@ Do these once, in order, after `scripts/run.sh` has completed. Tick and date.
 - [ ] Live > Settings > Audio: once an interface is attached, pick it, 48 kHz, buffer 128 (raise if crackle). Test with the DAW Focus on and the lid open on AC for 15 min: no sleep, no notification.
 ## tank
- [ ] Finder > Go > Go to Folder > `/Volumes/tank` (this triggers the mount), then drag the `tank` folder from the path bar / window title into the sidebar **Favorites**. It will NOT appear under Locations as a drive: macOS marks every automounted share `nobrowse` (documented in `man auto_master`) — the Favorite is the one-click entry, and the share mounts on first click and unmounts when idle, so leaving the LAN never hangs Finder or throws login dialogs.
+- [ ] Finder > **Cmd+Shift+G** > `/Volumes/tank` (this triggers the mount; `/Volumes` is a hidden folder — you won't find it by browsing Macintosh HD, and `/System/Volumes` is something else), then drag the `tank` folder from the path bar / window title into the sidebar **Favorites**. It will NOT appear under Locations as a drive: macOS marks every automounted share `nobrowse` (documented in `man auto_master`) — the Favorite is the one-click entry, and the share mounts on first click and unmounts when idle, so leaving the LAN never hangs Finder or throws login dialogs.
 - [ ] After the first reboot: `mount | grep auto_smb` in kitty should show the `/Volumes/tank` trigger. If it's gone, `/Volumes` got cleaned at boot — tell Claude; the fix is a `synthetic.conf` mountpoint instead.
 ## Backup