Claude Remote Status EXE
Pre-release
Pre-release
Desktop server (claude-remote-server-*.exe / linux / darwin)
What's new
- Token authentication everywhere — every API and WebSocket request is now
gated by an auto-generated token (~/.claude/claude-remote-token); origin and
CORS policies are restricted instead of wildcard-open. The QR and terminal URL
carry the token so pairing stays one step. - Accurate session tracking — an event-driven state machine replaces the
old 4-second idle guess. Long-running tools are never falsely marked
finished; a turn ends on the real Stop hook or a transcript-based end-of-turn
detection, and a 5-minute "stalled" warning is the last resort — never a
false "task completed". - Durable by default — hook events spool to disk while the server is down
and are replayed on startup, and a rolling event log rebuilds recent session
state after crashes, kills, and restarts. No event is silently lost. - Survives reboots — run
claude-remote-server.exe -installonce from an
elevated console to auto-start at sign-in. A single-instance guard makes
duplicate launches exit cleanly, console close is handled gracefully, and
-log-fileadds rotating file logging.GET /api/healthexposes uptime and
last-event time. - Relay support built in — run with
--relay wss://your-relay.example
(or set it at runtime from the web dashboard; the setting persists). The
server dials out, so no port forwarding or public IP is needed. - New web dashboard — the built-in page now connects with its token, shows
live status and sub-agents with a clear completed state, offers copyable
URL/token rows, and lets you configure the relay at runtime.
Upgrade notes
- Breaking: clients must present the token. Re-pair the Android app by scanning
the QR printed at startup. The hook bridge and settings are upgraded
automatically on first run. - Optional:
--relay,-idle-timeout(default 300s),-log-file,-install/
-uninstall— see the README for the full flag table.