diff --git a/CLAUDE.md b/CLAUDE.md
index 492a5adf..60fe1ae8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -165,6 +165,19 @@ symlink or a real copy. If it's a symlink to your working directory, be aware th
 gen-skill-docs pipeline, consider whether the changes should be tested in isolation
 before going live (especially if the user is actively using gstack in other windows).
 
+## Compiled binaries — NEVER commit browse/dist/
+
+The `browse/dist/` directory contains compiled Bun binaries (`browse`, `find-browse`,
+~58MB each). These are Mach-O arm64 only — they do NOT work on Linux, Windows, or
+Intel Macs. The `./setup` script already builds from source for every platform, so
+the checked-in binaries are redundant. They are tracked by git due to a historical
+mistake and should eventually be removed with `git rm --cached`.
+
+**NEVER stage or commit these files.** They show up as modified in `git status`
+because they're tracked despite `.gitignore` — ignore them. When staging files,
+always use specific filenames (`git add file1 file2`) — never `git add .` or
+`git add -A`, which will accidentally include the binaries.
+
 ## Commit style
 
 **Always bisect commits.** Every commit should be a single logical change. When
diff --git a/browse/dist/browse b/browse/dist/browse
deleted file mode 100755
index 79562b32..00000000
Binary files a/browse/dist/browse and /dev/null differ
diff --git a/browse/dist/find-browse b/browse/dist/find-browse
deleted file mode 100755
index fe55e4a9..00000000
Binary files a/browse/dist/find-browse and /dev/null differ