- cladm detects active Claude Code sessions and shows their real-time status.
- When Claude finishes responding, a sound notification plays so you never miss it.
+ cladm detects all running Claude Code sessions across every project and shows their real-time status.
+ When any session finishes, a sound plays and the dock icon bounces — so you never miss it, even across dozens of parallel sessions.
@@ -298,10 +301,11 @@ export default function Home() {
- Detection works by monitoring JSONL file modification times in{" "}
- ~/.claude/projects/. Sessions
- writing within 5 seconds are busy; otherwise idle. Header shows
- total busy/idle count across all projects.
+ Detection reads the tail of each session's JSONL in{" "}
+ ~/.claude/projects/. A session is
+ busy if the file was written recently OR the last assistant message
+ has a pending tool call. This prevents false idle triggers during
+ long-running tools and subtasks.
@@ -310,6 +314,106 @@ export default function Home() {
+ {/* ══════ USAGE + IDLE PANELS ══════ */}
+
+
+ // USAGE & IDLE PANELS
+
+
+
+ {/* Usage panel mock */}
+
+
+
+
+ USAGE TRACKING
+
+
+
+
+
+
+
Session
+
+ {"████████"}
+ {"░░░░░░░░░░"}
+ 22%
+
+
resets 3h 2m · $1.82/h
+
+
+
All models $412
+
+ {"████████████"}
+ {"░░░░░░"}
+ 69%
+
+
+
+
Sonnet $31
+
+ {"█"}
+ {"░░░░░░░░░░░░░░░░░"}
+ 5%
+
+
+
+
Feb total $1,847
+
$2.41/h avg · 8,234 reqs
+
+
+
+
+ Press u to toggle. Tracks session (5h window), weekly
+ all-model and sonnet-only costs against configurable plan limits.
+
+
+
+ {/* Idle sessions panel mock */}
+
+
+
+
+ IDLE SESSIONS
+
+
+
+
+
+
+ {" TIME PROJECT SESSION"}
+
+
+ ◉
+ 12s
+ acme-api
+ "Fix rate limiter..."
+
+
+ ◉
+ 2m{" "}
+ quantum-dash
+ "Build chart tooltip..."
+
+
+ ◉
+ 8m{" "}
+ ml-pipeline
+ "Add BERT tokenizer..."
+
+
+
+
+ Press i to toggle. Shows sessions waiting for your
+ input, sorted by most recently idle. Press Enter to focus a session's
+ Terminal tab directly.
+
+
+
+
+
+
{/* ══════ FEATURES ══════ */}
@@ -317,6 +421,26 @@ export default function Home() {
+ }
+ title="LIVE MONITORING"
+ desc="Track all Claude sessions across every project. Busy/idle status updates in real time with elapsed timers."
+ />
+ }
+ title="USAGE TRACKING"
+ desc="Session, weekly, and monthly cost bars. Track all-model and sonnet-only usage against configurable plan limits."
+ />
+ }
+ title="NOTIFICATIONS"
+ desc="Sound + dock bounce when any session finishes. Never miss a completed task across dozens of parallel sessions."
+ />
+ }
+ title="FOCUS SESSION"
+ desc="Press Enter on any idle session to instantly focus its Terminal tab. Flash animation highlights the window."
+ />
}
title="AUTO-DISCOVERY"
@@ -325,28 +449,13 @@ export default function Home() {
}
title="GIT METADATA"
- desc="Branch, sync status (ahead/behind), last commit, dirty state — all loaded in parallel."
+ desc="Branch, sync status (ahead/behind), last commit, dirty state — all loaded in parallel per project."
/>
}
title="SESSION BROWSER"
desc="Expand any project to browse past sessions. See conversation previews and resume directly."
/>
- }
- title="BRANCH SWITCHING"
- desc="Select a non-current branch to launch Claude with an auto-prompt to switch and stash."
- />
- }
- title="LIVE ACTIVITY"
- desc="See which sessions are busy or idle in real time. Green dot = Claude is working. Yellow dot + elapsed time = waiting for input."
- />
- }
- title="DONE SOUND"
- desc="Plays a sound when Claude finishes responding. Never miss a completed task — even across multiple sessions."
- />
}
title="PARALLEL LAUNCH"
@@ -376,12 +485,15 @@ export default function Home() {
["Space", "Toggle selection"],
["→", "Expand project"],
["←", "Collapse"],
+ ["Enter", "Launch selected / focus session"],
+ ["i", "Toggle idle sessions panel"],
+ ["u", "Toggle usage panel"],
+ ["/", "Filter projects"],
["a", "Select all"],
["n", "Deselect all"],
["s", "Cycle sort mode"],
["f", "Open folder in Finder"],
["g", "Go to active session"],
- ["Enter", "Launch selected"],
["PgUp PgDn", "Jump 15 rows"],
["q / Esc", "Quit"],
].map(([key, desc]) => (