feat: add running process count for better instance detection

- Add RunningProcesses field to TmuxMetrics
- Count claude processes via pgrep for reliable detection
- Display "tracked/total procs" when counts differ
- Helps identify detection gaps when hooks aren't working

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: jedarden

internal/metrics/tmux.go

@@ -78,14 +78,15 @@ type TmuxSession struct {
 
 // TmuxMetrics holds information about all tmux sessions
 type TmuxMetrics struct {
-	Sessions       []TmuxSession `json:"sessions"`
-	Total          int           `json:"total"`
-	Available      bool          `json:"available"`
-	Error          string        `json:"error,omitempty"`
-	LastUpdate     time.Time     `json:"last_update"`
-	HooksAvailable bool          `json:"hooks_available"` // Whether hook-based tracking is active
-	HooksInstalled bool          `json:"hooks_installed"` // Whether hooks are installed
-	Source         string        `json:"source"`          // "hooks", "tmux", or "hybrid"
+	Sessions         []TmuxSession `json:"sessions"`
+	Total            int           `json:"total"`
+	Available        bool          `json:"available"`
+	Error            string        `json:"error,omitempty"`
+	LastUpdate       time.Time     `json:"last_update"`
+	HooksAvailable   bool          `json:"hooks_available"`   // Whether hook-based tracking is active
+	HooksInstalled   bool          `json:"hooks_installed"`   // Whether hooks are installed
+	Source           string        `json:"source"`            // "hooks", "tmux", or "hybrid"
+	RunningProcesses int           `json:"running_processes"` // Number of running claude processes
 }
 
 // TmuxCollector collects metrics about tmux sessions
@@ -227,6 +228,7 @@ func (tc *TmuxCollector) Collect() *TmuxMetrics {
 
 	metrics.Available = hasTmux || hasHooks
 	metrics.Total = len(metrics.Sessions)
+	metrics.RunningProcesses = tc.countRunningClaudeProcesses()
 
 	if !metrics.Available && !tc.isTmuxAvailable() {
 		metrics.Error = "tmux is not installed or not available in PATH"
@@ -572,6 +574,28 @@ func (tc *TmuxCollector) fallbackStatus(session TmuxSession, now time.Time) Sess
 	return StatusReady
 }
 
+// countRunningClaudeProcesses counts the number of running claude processes
+// This provides a reliable count independent of hooks or tmux
+func (tc *TmuxCollector) countRunningClaudeProcesses() int {
+	ctx, cancel := context.WithTimeout(context.Background(), tmuxCommandTimeout)
+	defer cancel()
+
+	// Use pgrep to count claude processes (exact match to avoid false positives)
+	cmd := exec.CommandContext(ctx, "pgrep", "-x", "claude")
+	var stdout bytes.Buffer
+	cmd.Stdout = &stdout
+
+	_ = cmd.Run() // Ignore error - pgrep returns 1 if no matches
+
+	output := strings.TrimSpace(stdout.String())
+	if output == "" {
+		return 0
+	}
+
+	// Count lines (each line is a PID)
+	return len(strings.Split(output, "\n"))
+}
+
 // GetMetrics is a convenience method that returns the collected metrics
 func (tc *TmuxCollector) GetMetrics() *TmuxMetrics {
 	return tc.Collect()

internal/ui/dashboard.go

@@ -1215,7 +1215,12 @@ func (d *Dashboard) renderTmuxPanel(width, height int) string {
 		// Hooks installed but no hook sessions, falling back to tmux
 		sourceLabel = "Sessions (tmux)"
 	}
-	title := successStyle.Render(fmt.Sprintf("%s %s (%d)", sourceIcon, sourceLabel, d.tmuxMetrics.Total))
+	// Show process count if different from tracked sessions (indicates detection gap)
+	countStr := fmt.Sprintf("%d", d.tmuxMetrics.Total)
+	if d.tmuxMetrics.RunningProcesses > 0 && d.tmuxMetrics.RunningProcesses != d.tmuxMetrics.Total {
+		countStr = fmt.Sprintf("%d/%d procs", d.tmuxMetrics.Total, d.tmuxMetrics.RunningProcesses)
+	}
+	title := successStyle.Render(fmt.Sprintf("%s %s (%s)", sourceIcon, sourceLabel, countStr))
 	titleLen := lipgloss.Width(title)
 	summaryLen := lipgloss.Width(statusSummary)
 	spacing := contentWidth - titleLen - summaryLen