You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+26-9Lines changed: 26 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,31 +10,47 @@ Run the setup script to initialize submodules and build GhosttyKit:
10
10
11
11
## Local dev
12
12
13
-
After making code changes, always run the reload script with a tag to launch the Debug app:
13
+
After making code changes, always run the reload script with a tag to build the Debug app:
14
14
15
15
```bash
16
16
./scripts/reload.sh --tag fix-zsh-autosuggestions
17
17
```
18
18
19
-
When reporting a tagged reload result in chat, use the format for your agent type:
19
+
By default, `reload.sh` builds but does **not** launch the app. The script prints the `.app` path so the user can cmd-click to open it. Pass `--launch` to kill any existing instance and open the app automatically:
20
20
21
-
**Claude Code** (markdown link with correct derived-data path, cmd+clickable):
[cmux DEV <tag-name>.app](file:///Users/lawrencechen/Library/Developer/Xcode/DerivedData/cmux-<tag-name>/Build/Products/Debug/cmux%20DEV%20<tag-name>.app)
40
+
[cmux DEV my-tag.app](file:///Users/someone/Library/Developer/Xcode/DerivedData/cmux-my-tag/Build/Products/Debug/cmux%20DEV%20my-tag.app)
Never use `/tmp/cmux-<tag>/...` app links in chat output. If the expected DerivedData path is missing, resolve the real `.app` path and report that `file://` URL.
51
+
Never use `/tmp/cmux-<tag>/...` app links in chat output.
36
52
37
-
After making code changes, always use `reload.sh --tag` to build and launch. **Never run bare `xcodebuild` or `open` an untagged `cmux DEV.app`.** Untagged builds share the default debug socket and bundle ID with other agents, causing conflicts and stealing focus.
53
+
After making code changes, always use `reload.sh --tag` to build. **Never run bare `xcodebuild` or `open` an untagged `cmux DEV.app`.** Untagged builds share the default debug socket and bundle ID with other agents, causing conflicts and stealing focus.
38
54
39
55
```bash
40
56
./scripts/reload.sh --tag <your-branch-slug>
@@ -58,10 +74,11 @@ When rebuilding cmuxd for release/bundling, always use ReleaseFast:
58
74
cd cmuxd && zig build -Doptimize=ReleaseFast
59
75
```
60
76
61
-
`reload` = kill and launch the Debug app only (tag required):
77
+
`reload` = build the Debug app (tag required). Pass `--launch` to also kill existing and open:
0 commit comments