Skip to content

fix(desktop): friendly already-running guard for clawcodex desktop - #808

Merged
agentforce314 merged 1 commit into
mainfrom
fix/desktop-launch-port-guard
Aug 8, 2026
Merged

fix(desktop): friendly already-running guard for clawcodex desktop#808
agentforce314 merged 1 commit into
mainfrom
fix/desktop-launch-port-guard

Conversation

@agentforce314

Copy link
Copy Markdown
Owner

A second clawcodex desktop died mid-boot on vite's raw Port 5174 is already in use stack trace (user hit this when an instance was already up).

Now the launcher probes the dev renderer port first and explains:

desktop: ClawCodex Desktop appears to be already running (port 5174 is in use).
Switch to its window, or quit it and run this again.

--no-dev launches skip the guard (they don't bind the dev port). Covered by a socket-listener test (guard trips while held, clears when released, subcommand exits 1 with the message).

🤖 Generated with Claude Code

A second `clawcodex desktop` died mid-boot on vite's raw
'Port 5174 is already in use' stack trace. Probe the dev renderer port
before launching and explain the situation instead: the app is almost
certainly already running — switch to its window or quit it.

--no-dev launches skip the guard (they don't bind the dev port).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@agentforce314
agentforce314 enabled auto-merge (squash) August 8, 2026 08:17
@agentforce314
agentforce314 merged commit 176b2df into main Aug 8, 2026
@agentforce314 agentforce314 mentioned this pull request Aug 8, 2026
agentforce314 added a commit that referenced this pull request Aug 8, 2026
ClawCodex Desktop headlines 1.5.0: the native app (ui-desktop/), the
clawcodex serve gateway backing it, the clawcodex desktop launcher, official
crab branding, and macOS packaging — plus the ship-week fixes (lib/
tracking, 100% default UI scale, already-running launch guard).

- version 1.4.0 -> 1.5.0 (pyproject + src/__init__ fallback)
- CHANGELOG: cut [1.5.0] from Unreleased (#802-#808)
- News: v1.5.0 item in README (v0.6.0 rotated to docs/NEWS.md archive)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant