Graceful startup when no Claude Code sessions exist

Start TUI with empty tree instead of crashing when ~/.claude doesn't
exist or no sessions are found. Auto-discovers sessions as they appear.

- Don't error in New() when session not found or dir missing
- Watch ancestor directory when claudeDir doesn't exist yet
- Switch to full recursive watch when claudeDir is created
- Show "Waiting for Claude Code sessions..." in empty tree
- Show "Waiting..." in header when 0 sessions
- Bump version to 0.3.1

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

Author: phiat

internal/tui/model.go

@@ -380,7 +380,9 @@ func (m *Model) renderHeader() string {
 		if !m.watcher.IsAutoDiscoveryEnabled() {
 			autoDisc = " [paused]"
 		}
-		if len(sessions) == 1 {
+		if len(sessions) == 0 {
+			sessionInfo = "Waiting..."
+		} else if len(sessions) == 1 {
 			for _, s := range sessions {
 				sessionInfo = fmt.Sprintf("Session: %s%s", truncate(s.ID, 12), autoDisc)
 			}

internal/tui/tree.go

@@ -418,7 +418,7 @@ func (t *TreeView) SetSize(width, height int) {
 // View renders the tree
 func (t *TreeView) View() string {
 	if len(t.nodes) == 0 {
-		return mutedStyle.Render("No sessions")
+		return mutedStyle.Render("Waiting for Claude Code sessions...")
 	}
 
 	var b strings.Builder

internal/watcher/watcher.go

@@ -223,17 +223,15 @@ func New(sessionID string, pollInterval time.Duration) (*Watcher, error) {
 	w.watchActive.Store(sessionID == "") // watch all active if no specific session
 
 	if sessionID != "" {
-		// Watch a specific session
+		// Watch a specific session (graceful — don't crash if not found yet)
 		session, err := w.findSession(sessionID)
-		if err != nil {
-			return nil, err
+		if err == nil {
+			w.sessions[session.ID] = session
 		}
-		w.sessions[session.ID] = session
+		// If not found, watch loops will discover it
 	} else {
-		// Find all active sessions
-		if err := w.discoverActiveSessions(); err != nil {
-			return nil, err
-		}
+		// Find all active sessions (ignore errors — dir may not exist yet)
+		_ = w.discoverActiveSessions()
 	}
 
 	return w, nil
@@ -753,7 +751,11 @@ func (w *Watcher) watchLoopFsnotify() {
 	defer cleanupTicker.Stop()
 
 	// Set up directory watches for discovery
-	w.addDirectoryWatches(w.claudeDir)
+	if _, err := os.Stat(w.claudeDir); err == nil {
+		w.addDirectoryWatches(w.claudeDir)
+	} else {
+		w.watchAncestorDirectory(w.claudeDir)
+	}
 
 	// Register file watches for all known sessions
 	sessions := w.getSessionsSnapshot()
@@ -788,6 +790,22 @@ func (w *Watcher) watchLoopFsnotify() {
 	}
 }
 
+// watchAncestorDirectory watches the closest existing ancestor of a path
+func (w *Watcher) watchAncestorDirectory(target string) {
+	dir := target
+	for {
+		parent := filepath.Dir(dir)
+		if parent == dir {
+			break
+		}
+		if _, err := os.Stat(parent); err == nil {
+			w.fsWatcher.Add(parent)
+			return
+		}
+		dir = parent
+	}
+}
+
 // addDirectoryWatches recursively adds fsnotify watches on directories
 func (w *Watcher) addDirectoryWatches(root string) {
 	filepath.Walk(root, func(path string, info os.FileInfo, err error) error {
@@ -846,6 +864,13 @@ func (w *Watcher) handleFsCreate(path string) {
 	// New directory — add a watch so we catch files created inside it
 	if info.IsDir() {
 		w.fsWatcher.Add(path)
+		// If claude_dir was just created, switch to full recursive watch
+		if strings.HasPrefix(w.claudeDir, path) || path == w.claudeDir {
+			if _, err := os.Stat(w.claudeDir); err == nil {
+				w.addDirectoryWatches(w.claudeDir)
+				_ = w.discoverActiveSessions()
+			}
+		}
 		return
 	}
 

main.go

@@ -24,7 +24,7 @@ import (
 )
 
 var (
-	version = "0.3.0"
+	version = "0.3.1"
 )
 
 func main() {