The open-source Arc replacement for macOS. Spaces, pinned tabs, split view, Little Windows and Arc's shortcuts on Chromium, with your Arc sidebar imported in one go.
Clean up what test copies leave behind, after every Claude Code turn
Victor098376ca41b8
diff --git a/.claude/settings.json b/.claude/settings.jsonindex a178ca6..d6dc80c 100644--- a/.claude/settings.json+++ b/.claude/settings.json@@ -12,6 +12,17 @@}]}+ ],+ "Stop": [+ {+ "hooks": [+ {+ "type": "command",+ "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/clean-test-leftovers.sh --hook",+ "timeout": 10+ }+ ]+ }]}}diff --git a/docs/development.md b/docs/development.mdindex 0a6bd4a..3da6669 100644--- a/docs/development.md+++ b/docs/development.md@@ -187,6 +187,23 @@ empty, click-through and never key. Pages go back into their window while DevToo`CRA_EMBED_PAGES=0` (or `defaults write dk.kildahl.cra embedPages -bool NO`) keeps pages intheir own child windows, the hosting before 0.1.17, for comparing the two.+### Cleaning up after test copies++A renamed test copy leaves files outside its own folder: a 300 MB–1 GB code sign clone in+the per-user temp folder when it's killed instead of quit, plus caches, preferences and+LaunchServices entries under its bundle id. Dozens of them filled a 460 GB disk. Give a+copy a bundle id starting with `dk.kildahl.cra.test.` (or another `dk.kildahl.cra`,+`dk.kildahl.test.`, `app.crabrowser.` or `dev.cra.` id), quit it through its menu rather+than killing it, and delete it when you're done.++`scripts/clean-test-leftovers.sh` removes what's left: clones no process has open, the data+of test bundle ids that aren't running, Claude Code scratchpads of this repo that haven't+changed for a day, and LaunchServices entries of deleted Cra bundles. It never touches+the installed Cra's ids, CraClip, a running app or anything changed in the last hour. Use+`--dry-run` to see what it would do. In Claude Code it runs in the background at most every+30 minutes as a Stop hook (`.claude/settings.json`), and the log of the last run is+`$(getconf DARWIN_USER_TEMP_DIR)cra-clean-test-leftovers.log`.+## Scripting hooksCra registers the `cra://` scheme so it can be driven from a shell:diff --git a/scripts/clean-test-leftovers.sh b/scripts/clean-test-leftovers.shnew file mode 100755index 0000000..1b24454--- /dev/null+++ b/scripts/clean-test-leftovers.sh@@ -0,0 +1,165 @@+#!/bin/bash+# Removes what Cra test runs leave behind on this Mac, which otherwise fills the disk:+#+# 1. code sign clones: Chromium copies a running app bundle into+# $(getconf DARWIN_USER_TEMP_DIR)/../X/<bundle id>.code_sign_clone and deletes the copy on+# a normal quit. A killed or crashed test copy leaves it (300 MB–1 GB each). Clones of any+# app (Chrome too) go, as long as no process has them open. macOS drops them at reboot anyway.+# 2. per-bundle data of Cra test copies (bundle ids dk.kildahl.cra*, dk.kildahl.test.*,+# app.crabrowser.*, dev.cra.*, app.cra.*): Caches, HTTPStorages, WebKit, Saved Application+# State, Preferences and the per-user temp/cache folders. Never the installed Cra's own ids,+# never CraClip (dk.kildahl.cra.clip), never an app that is running.+# 3. Claude Code scratchpads of this repo's finished sessions (main checkout and ../cra-wt-*+# worktrees): test bundles, data folders, recordings. A session's folder goes once nothing+# in it changed for --scratch-hours (default 24) and no process has a file in it open.+# 4. LaunchServices entries of Cra bundles that no longer exist.+#+# Usage:+# scripts/clean-test-leftovers.sh [--dry-run] [--scratch-hours N] [--keep-session ID]+# scripts/clean-test-leftovers.sh --hook # Claude Code Stop hook: detaches, at most every 30 min+#+# Anything touched in the last hour is left alone, so a test copy that is starting up keeps its+# files. Safe to run while other sessions test: running apps and open files are skipped.+set -u++DRY=0+SCRATCH_HOURS=24+KEEP_SESSION=""+HOOK=0+while [ $# -gt 0 ]; do+ case "$1" in+ --dry-run) DRY=1 ;;+ --scratch-hours) SCRATCH_HOURS="$2"; shift ;;+ --keep-session) KEEP_SESSION="$2"; shift ;;+ --hook) HOOK=1 ;;+ -h|--help) sed -n '2,25p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;+ *) echo "unknown option: $1" >&2; exit 64 ;;+ esac+ shift+done++USER_TEMP="$(cd "$(getconf DARWIN_USER_TEMP_DIR)" && pwd -P)" # …/T+VAR_USER="$(dirname "$USER_TEMP")" # …/<hash>+STATE="$USER_TEMP/cra-clean-test-leftovers"+LOG="$STATE.log"++if [ "$HOOK" = 1 ]; then+ # The Stop hook passes {"session_id": …} on stdin. Return at once; the work runs detached.+ session="$(sed -n 's/.*"session_id" *: *"\([^"]*\)".*/\1/p' | head -1)"+ [ -n "$(find "$STATE.stamp" -mmin -30 2>/dev/null)" ] && exit 0+ touch "$STATE.stamp"+ nohup "$0" --keep-session "$session" >"$LOG" 2>&1 </dev/null &+ exit 0+fi++# One run at a time (a lock older than an hour is from a run that died).+LOCK="$STATE.lock"+[ -n "$(find "$LOCK" -maxdepth 0 -mmin +60 2>/dev/null)" ] && rmdir "$LOCK" 2>/dev/null+mkdir "$LOCK" 2>/dev/null || { echo "another cleanup is running"; exit 0; }+trap 'rmdir "$LOCK" 2>/dev/null' EXIT++LSREGISTER=/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister+TEST_ID_RE='^(dk\.kildahl\.(cra|test\.)|app\.crabrowser\.|dev\.cra\.|app\.cra\.)'+WORK="$(mktemp -d "$USER_TEMP/cra-clean.XXXXXX")"+trap 'rmdir "$LOCK" 2>/dev/null; rm -rf "$WORK"' EXIT++say() { echo "$@"; }+remove() { # remove <path>…+ for p in "$@"; do+ [ -e "$p" ] || [ -L "$p" ] || continue+ if [ "$DRY" = 1 ]; then say "would remove $p"; else rm -rf "$p" && say "removed $p"; fi+ done+}+recent() { [ -n "$(find "$1" -maxdepth 0 -mmin -60 2>/dev/null)" ]; } # touched in the last hour+free_kb() { df -k "$HOME" | awk 'NR==2 {print $4}'; }+before="$(free_kb)"++scratch_root="$(cd "/tmp/claude-$(id -u)" 2>/dev/null && pwd -P)"++# Everything under the cleaned folders that a process of this user has open, is in or runs.+{ lsof -nP -Fn 2>/dev/null | sed -n 's/^n//p'; ps -axww -o command=; } |+ grep -F -e "$VAR_USER" -e "$HOME/Library" -e "/tmp/claude-" | sort -u >"$WORK/in-use"+# A process running from a code sign clone shows up under the clone's path only through +D+# (a plain lsof names the original bundle, whose blocks the clone shares).+lsof -nP -Fn +D "$VAR_USER/X" 2>/dev/null | sed -n 's/^n//p' >>"$WORK/in-use"+lsappinfo list 2>/dev/null | sed -n 's/.*bundleID="\([^"]*\)".*/\1/p' | sort -u >"$WORK/running-ids"+in_use() { grep -qF -- "$1" "$WORK/in-use"; }++# Ids that must never be cleaned: the installed Cra's bundles, CraClip, and running apps.+{+ find /Applications/Cra.app -maxdepth 6 -name Info.plist 2>/dev/null |+ while read -r plist; do /usr/libexec/PlistBuddy -c 'Print :CFBundleIdentifier' "$plist" 2>/dev/null; done+ printf '%s\n' dk.kildahl.cra dk.kildahl.cra.docktile dk.kildahl.cra.clip+ lsappinfo list 2>/dev/null | sed -n 's/.*bundleID="\([^"]*\)".*/\1/p'+} | sort -u >"$WORK/keep-ids"+protected() { # protected <id>: a kept id, a helper of one, or one of the installed Cra's parts+ local base="${1%%.helper*}"+ grep -qxF -- "$1" "$WORK/keep-ids" || grep -qxF -- "$base" "$WORK/keep-ids" ||+ case "$1" in dk.kildahl.cra.helper*|dk.kildahl.cra.clip.*) return 0 ;; *) return 1 ;; esac+}++# 1. Code sign clones nobody has open.+for dir in "$VAR_USER"/X/*.code_sign_clone; do+ [ -d "$dir" ] || continue+ newest=""+ if grep -qxF -- "$(basename "$dir" .code_sign_clone)" "$WORK/running-ids"; then+ newest="$(ls -td "$dir"/* 2>/dev/null | head -1)" # a running app's own clone, in case lsof missed it+ fi+ for clone in "$dir"/*; do+ [ -e "$clone" ] || continue+ [ "$clone" = "$newest" ] && continue+ recent "$clone" && continue+ in_use "$clone" && continue+ remove "$clone"+ done+done++# 2. Per-bundle data of Cra test copies.+for loc in "$HOME/Library/Caches" "$HOME/Library/HTTPStorages" "$HOME/Library/WebKit" \+ "$HOME/Library/Saved Application State" "$HOME/Library/Preferences" \+ "$VAR_USER/C" "$VAR_USER/T"; do+ [ -d "$loc" ] || continue+ ls "$loc" | grep -iE "$TEST_ID_RE" | while read -r name; do+ item="$loc/$name"+ id="${name%.savedState}"; id="${id%.plist}"; id="${id%.binarycookies}"+ if [ "$loc" = "$VAR_USER/T" ] || [ "$loc" = "$VAR_USER/C" ]; then+ # Temp items are named <bundle id>.<random> (the installed Cra makes dk.kildahl.cra.AbC123).+ id="$(echo "$id" | sed -E 's/\.chromium_chrome_url_fetcher_\..*$//; s/\.[A-Za-z0-9]{6}$//')"+ fi+ protected "$id" && continue+ recent "$item" && continue+ in_use "$item" && continue+ if [ "$loc" = "$HOME/Library/Preferences" ] && [ "$DRY" = 0 ]; then+ defaults delete "$id" >/dev/null 2>&1 # keeps cfprefsd's cache in step with the file+ fi+ remove "$item"+ done+done++# 3. Scratchpads of this repo's finished sessions.+repo="$(cd "$(git -C "$(dirname "$0")" rev-parse --path-format=absolute --git-common-dir)/.." && pwd -P)"+slug="$(echo "$repo" | sed 's#[/.]#-#g')"+if [ -n "$scratch_root" ]; then+ for project in "$scratch_root/$slug" "$scratch_root/$slug"-wt-* "$scratch_root/$slug"--claude-worktrees-*; do+ [ -d "$project" ] || continue+ for session in "$project"/*/; do+ session="${session%/}"+ [ -n "$KEEP_SESSION" ] && [ "$(basename "$session")" = "$KEEP_SESSION" ] && continue+ [ -n "$(find "$session" -mmin "-$((SCRATCH_HOURS * 60))" -print -quit 2>/dev/null)" ] && continue+ in_use "$session/" && continue+ remove "$session"+ done+ done+fi++# 4. LaunchServices entries of Cra bundles that are gone (helpers are registered on their own).+"$LSREGISTER" -dump 2>/dev/null |+ sed -n 's/^path: *\(.*\.app\) (0x[0-9a-f]*)$/\1/p' | sort -u |+ grep -iE "cra|/tmp/claude-|/private/tmp/claude-" |+ while read -r app; do+ [ -e "$app" ] && continue+ if [ "$DRY" = 1 ]; then say "would unregister $app"; else "$LSREGISTER" -u "$app" 2>/dev/null; say "unregistered $app"; fi+ done++after="$(free_kb)"+say "free space: $((before / 1048576)) GB → $((after / 1048576)) GB"