Summary
supertag update install --file ... --yes fails on macOS because the updater appears to copy the extracted release directory to the supertag binary path instead of copying the supertag binary inside that directory.
Environment
- macOS on Apple Silicon / arm64
- Installed version before update:
2.5.9
- Target version:
2.5.11
- Downloaded update:
/Users/ryan/.cache/supertag/supertag-2.5.11.zip
- Current install path:
/Users/ryan/Tools/supertag-cli/supertag
Repro
supertag --version
supertag update download
supertag update install --file /Users/ryan/.cache/supertag/supertag-2.5.11.zip --yes
Actual
🔄 Installing update...
Update file: /Users/ryan/.cache/supertag/supertag-2.5.11.zip
Binary path: /Users/ryan/Tools/supertag-cli/supertag
❌ Installation failed: Installation failed: ENOTSUP: operation not supported on socket, copyfile '/Users/ryan/.cache/supertag/extract-2026-06-29T02-53-15-327Z/supertag-cli-macos-arm64' -> '/Users/ryan/Tools/supertag-cli/supertag'
After this, supertag --version still reported 2.5.9.
Expected
The updater should copy:
supertag-cli-macos-arm64/supertag
to:
/Users/ryan/Tools/supertag-cli/supertag
It may also need to update the sibling binaries:
supertag-cli-macos-arm64/supertag-mcp
supertag-cli-macos-arm64/supertag-export
Evidence
unzip -l /Users/ryan/.cache/supertag/supertag-2.5.11.zip shows the release zip root is a directory:
supertag-cli-macos-arm64/
supertag-cli-macos-arm64/supertag
supertag-cli-macos-arm64/supertag-mcp
supertag-cli-macos-arm64/supertag-export
The error path suggests the updater tries to copy:
.../extract-.../supertag-cli-macos-arm64
directly to:
/Users/ryan/Tools/supertag-cli/supertag
instead of copying the binary one level deeper.
Workaround
Manual unzip and copying the three binaries worked:
tmp=$(mktemp -d)
unzip -q /Users/ryan/.cache/supertag/supertag-2.5.11.zip -d "$tmp"
install -m 755 "$tmp/supertag-cli-macos-arm64/supertag" /Users/ryan/Tools/supertag-cli/supertag
install -m 755 "$tmp/supertag-cli-macos-arm64/supertag-mcp" /Users/ryan/Tools/supertag-cli/supertag-mcp
install -m 755 "$tmp/supertag-cli-macos-arm64/supertag-export" /Users/ryan/Tools/supertag-cli/supertag-export
supertag --version
After the workaround, supertag --version returned 2.5.11.
Summary
supertag update install --file ... --yesfails on macOS because the updater appears to copy the extracted release directory to thesupertagbinary path instead of copying thesupertagbinary inside that directory.Environment
2.5.92.5.11/Users/ryan/.cache/supertag/supertag-2.5.11.zip/Users/ryan/Tools/supertag-cli/supertagRepro
Actual
After this,
supertag --versionstill reported2.5.9.Expected
The updater should copy:
to:
It may also need to update the sibling binaries:
Evidence
unzip -l /Users/ryan/.cache/supertag/supertag-2.5.11.zipshows the release zip root is a directory:The error path suggests the updater tries to copy:
directly to:
instead of copying the binary one level deeper.
Workaround
Manual unzip and copying the three binaries worked:
After the workaround,
supertag --versionreturned2.5.11.