Detection layer: purple dot mapped to wrong session for same-cwd sessions

[grimmerk]

Problem

When multiple Claude Code sessions share the same project directory, the purple active dot (detection layer) may be placed on the wrong session item, and switch may jump to the wrong tab.

How to reproduce

1. Have two sessions with the same project path (e.g. both in ~/git/codex-ff)
2. Resume one session using claude -r (interactive picker) or claude -r <uuid>
3. Open CodeV Quick Switcher → Sessions tab
4. The purple dot appears on the most recently modified same-path session, not necessarily the one actually running

Tested with both iTerm2 and Ghostty — same behavior.

Root cause

detectActiveSessions() maps PIDs to session IDs using two passes:

1. First pass: match --resume <uuid> or -r <uuid> in process args via regex → correct mapping
2. Second pass: for processes without UUID in args, use lsof to find cwd → match to the first unclaimed session with that cwd

The second pass fails for same-cwd sessions because it picks whichever session comes first in the list.

Three bugs found:

1. Regex only matched --resume, not -r: claude -r <uuid> shows -r in process args, so the UUID was missed entirely.
2. No title-based disambiguation: claude -n "name", claude --resume "title" have no UUID — only a title. Without matching against custom titles, detection falls back to cwd matching.
3. claude -r (interactive picker) does NOT update process args: previously assumed args would update to --resume <uuid> after picker selection. Testing confirmed args remain claude -r with no UUID or title. This makes claude -r (picker) equivalent to bare claude for detection purposes.

Full same-cwd matrix

Detection layer (purple dot)

Launch command	Detection method	Needs terminal API?	Terminals
claude --resume <uuid>	UUID from process args	No	All
claude -r <uuid>	UUID from process args (-r regex fix)	No	All
claude -n "name"	Match name against session custom titles	No	All
claude --resume "title" / -r "title"	Match title against session custom titles	No	All
claude -r (interactive picker)	Same as bare claude — args stay claude -r, no UUID	See below	—
claude or claude -r (picker), later /rename'd	Cross-reference (not yet implemented)	Yes (per-tab TTY)	iTerm2 only
claude or claude -r (picker), never /rename'd	Unsolvable	—	None

Switch layer (click → jump to correct tab)

Launch command	Has custom title?	iTerm2	Ghostty / cmux
Any with /rename	Yes	Title match ✓	Title match ✓
claude -n "name"	Yes	Title match ✓	Title match ✓
claude -r "title"	Yes	Title match ✓	Title match ✓
-r <uuid> without /rename	No	TTY match ✓	cwd fallback ✗
claude / claude -r (picker), /rename'd + exited + resumed	Yes	Title match ✓	Title match ✓
claude / claude -r (picker), /rename'd but not exited	Yes (but detection wrong)	Wrong item clicked	Wrong item clicked
claude / claude -r (picker), never /rename'd	No	Unsolvable	✗

Fix (PR #61)

1. Regex fix: /--resume\s+/ → /(?:--resume|-r)\s+/
2. Title disambiguation: -n/--name/--resume "title" matched against custom titles
3. Docs: corrected claude -r picker behavior (args do NOT update), full matrix

Remaining unresolved

• claude -r (interactive picker) = same as bare claude for detection
• claude or claude -r + /rename'd but not exited → needs cross-reference (iTerm2 only)
• claude or claude -r + never /rename'd → unsolvable on all terminals

🤖 On behalf of @grimmerk — generated with Claude Code

[grimmerk]

Known limitation: claude -n "name" (or --name) before the first prompt — the session hasn't been written to history.jsonl yet (Claude Code only writes on first user message), so CodeV's session list doesn't include it. The PID gets assigned to another same-cwd session via cwd matching. This resolves itself after the first message is sent. Not fixable on CodeV's side — depends on Claude Code's data write timing.

🤖 On behalf of @grimmerk — generated with Claude Code

[grimmerk]

Update (PR #62): iTerm2 cross-reference is now implemented. Bare claude or claude -r sessions with in-session /rename now have correct detection (purple dot) on iTerm2 via TTY → tab name → custom title matching.

Remaining unsolvable: claude or claude -r + never /rename'd + same cwd = no terminal can fix this.

🤖 On behalf of @grimmerk — generated with Claude Code