Verified 2026-07-29. Treat application lifecycle, coding-session evidence, and usage authentication as independent signals. Combining them produces misleading errors and unreliable restore behavior.
Start with three different signals
- Application state: whether Claude Desktop is running, minimized, hidden, closed to background, or unavailable.
- Claude Code session state: whether an exact coding session is working, waiting, needs input, errored, finished, or stale.
- Usage state: the provider-reported quota window and whether the local credential used to read it is valid.
A valid Claude Desktop subscription does not prove that a Claude Code credential is available. A closed window does not prove the desktop process stopped. A stale transcript does not prove the corresponding application cannot be restored.
Restore the right surface
When a user chooses an exact session, retain the provider and session identity used to produce the status row. Restore logic should first determine which application surface owns that identity, then use the supported Windows activation path. Do not send every Claude-related row to one generic launch command.
Account for close-to-background behavior
Windows applications can remove their visible window while a process or tray component remains active. A monitor should distinguish no visible window from no process, and it should verify the result after requesting activation. Repeatedly starting another process can create duplicates without restoring the intended conversation.
Do not turn usage errors into session errors
If a usage request cannot authenticate, report that usage is unavailable. Preserve independently observed session state unless its own evidence changed. This keeps a provider quota failure from making a healthy local coding session look broken.
A practical Windows test checklist
- Open Claude Desktop and a Claude Code session separately.
- Verify that each row keeps its exact provider and session identity.
- Close Claude Desktop to background and restore it from the companion.
- Expire or remove only the usage credential and confirm session status remains intact.
- Reboot, reopen the same records, and verify that stale evidence is labeled rather than guessed.
Where Agent Island fits
Agent Island v1.7.1 is a free, open-source status companion for Claude Code and Codex on Windows 10/11 and macOS. It shows live session state and your-turn alerts from local records, uses no Agent Island account, and does not upload session data to Agent Island. It does not replace Claude authentication or control provider billing.
Continue with the Claude Code status reference, usage-window guide, or status-companion boundary.
← All posts