From afb50d16100527814b2a56839376dda4124c0bf8 Mon Sep 17 00:00:00 2001
From: Nelson Spence <ndspence@pm.me>
Date: Wed, 31 Dec 2025 04:18:21 -0600
Subject: [PATCH] fix: filter sidechain/warmup sessions from session list
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Claude Code creates internal "sidechain" sessions for context caching
and warmup purposes. These appear in the session list with names like
"Warmup" or "agent-*" and clutter the UI.

This change filters out these internal sessions by:
1. Checking if the filename starts with "agent-"
2. Parsing the first JSONL line and checking for isSidechain: true

Fixes #393

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 src-tauri/src/commands/claude.rs | 39 ++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/src-tauri/src/commands/claude.rs b/src-tauri/src/commands/claude.rs
index 529eb1a2..ce08a949 100644
--- a/src-tauri/src/commands/claude.rs
+++ b/src-tauri/src/commands/claude.rs
@@ -65,6 +65,9 @@ struct JsonlEntry {
     entry_type: Option<String>,
     message: Option<MessageContent>,
     timestamp: Option<String>,
+    /// Whether this is a sidechain/warmup session (should be hidden from UI)
+    #[serde(rename = "isSidechain")]
+    is_sidechain: Option<bool>,
 }
 
 /// Represents the message content
@@ -229,6 +232,36 @@ fn extract_first_user_message(jsonl_path: &PathBuf) -> (Option<String>, Option<S
     (None, None)
 }
 
+/// Checks if a session file is a sidechain/warmup session that should be hidden
+/// Returns true if the session should be filtered out from the UI
+fn is_sidechain_session(jsonl_path: &PathBuf) -> bool {
+    // First check: agent-* files are always sidechains
+    if let Some(filename) = jsonl_path.file_stem().and_then(|s| s.to_str()) {
+        if filename.starts_with("agent-") {
+            return true;
+        }
+    }
+
+    // Second check: parse first line and check isSidechain field
+    let file = match fs::File::open(jsonl_path) {
+        Ok(file) => file,
+        Err(_) => return false,
+    };
+
+    let reader = BufReader::new(file);
+
+    // Only check the first line - that's where isSidechain is set
+    if let Some(Ok(line)) = reader.lines().next() {
+        if let Ok(entry) = serde_json::from_str::<JsonlEntry>(&line) {
+            if entry.is_sidechain == Some(true) {
+                return true;
+            }
+        }
+    }
+
+    false
+}
+
 /// Helper function to create a tokio Command with proper environment variables
 /// This ensures commands like Claude can find Node.js and other dependencies
 fn create_command_with_env(program: &str) -> Command {
@@ -505,6 +538,12 @@ pub async fn get_project_sessions(project_id: String) -> Result<Vec<Session>, St
         let path = entry.path();
 
         if path.is_file() && path.extension().and_then(|s| s.to_str()) == Some("jsonl") {
+            // Skip sidechain/warmup sessions - these are internal Claude Code sessions
+            // that clutter the UI (agent-* files and sessions with isSidechain: true)
+            if is_sidechain_session(&path) {
+                continue;
+            }
+
             if let Some(session_id) = path.file_stem().and_then(|s| s.to_str()) {
                 // Get file creation time
                 let metadata = fs::metadata(&path)