tasktree-manager 2.0.1__tar.gz → 2.2.0__tar.gz

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/CHANGELOG.md

@@ -15,6 +15,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Git hooks support
 - Custom task metadata
 
+## [2.2.0] - 2026-03-06
+
+### Added
+- Add periodic auto-refresh for git status with selection preserv… (#3)
+
+
+## [2.1.0] - 2026-02-10
+
+### Added
+- Add context-aware info panel with task summary and focus-driven updates
+- Add Claude session status monitoring with Ghostty integration
+
+### Changed
+- Update example task names in README and user guide
+
+
 ## [2.0.1] - 2026-02-07
 
 ### Fixed

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasktree-manager
-Version: 2.0.1
+Version: 2.2.0
 Summary: TUI application for managing worktree-based tasks
 License-File: LICENSE
 Requires-Python: >=3.10

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/README.md

@@ -19,26 +19,18 @@
 - 🚀 **Fast & Responsive** - Parallel git operations with loading indicators
 - 🔧 **Flexible Configuration** - TOML config file, custom keybindings, environment variables
 
-## 📸 Screenshots
-
-```
-┌─ tasktree-manager ──────────────────────────────────────────────────────┐
-│  Tasks                    │  Worktrees                                   │
-│  ● DIC-1813 (2)          │    gitops-hpc         DIC-1813        ✗ 3   │
-│    DIC-1770-env          │    hpc                DIC-1813        ✓     │
-│                          │                                              │
-│                          │                                              │
-├──────────────────────────────────────────────────────────────────────────┤
-│  Status: gitops-hpc                                                      │
-│  Branch: DIC-1813                                                        │
-│  Sync:   ↑2 ↓1                                                          │
-│                                                                          │
-│   M  src/main.py                                                        │
-│   ?? README.md                                                          │
-│   M  tests/test_app.py                                                  │
-└──────────────────────────────────────────────────────────────────────────┘
-  n New task  d Delete  g Lazygit  p Push  r Refresh  ? Help  q Quit
-```
+## 📊 Status Indicators
+
+| Indicator | Meaning |
+|-----------|---------|
+| `●` red | Uncommitted changes |
+| `◆` blue | Has CLAUDE.md file |
+| `⟳` magenta | Claude Code session running |
+| `!` yellow | Claude Code session waiting for input |
+| `✓` green | Clean worktree / Claude session ended |
+| `✗ N` red | N files changed |
+| `↑N` green | N commits ahead of remote |
+| `↓N` yellow | N commits behind remote |
 
 ## 🚀 Quick Start
 
@@ -85,9 +77,11 @@ For detailed workflows and examples, see the [User Guide](docs/user-guide.md).
 | `n` | New task | `g` | Open lazygit |
 | `a` | Add repo | `e` | Open editor |
 | `d` | Delete task | `o` | Open folder |
-| `p` | Push all | `Enter` | Open shell |
+| `p` | Push all | `P` | Pull all |
+| `c` | Claude (resume) | `C` | Claude (new) |
 | `r` | Refresh | `s` | Sort tasks |
-| `S` | Group worktrees | `Tab` | Next panel |
+| `S` | Group worktrees | `m` | Messages |
+| `Enter` | Open shell | `Tab` | Next panel |
 | `?` | Show help | `q` | Quit |
 
 **Themes:** Press `Ctrl+P` to switch between 7 built-in themes (textual-dark, nord, gruvbox, tokyo-night, monokai, dracula, textual-light).

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/docs/configuration.md

@@ -93,6 +93,11 @@ theme = "textual-dark"
 # Default: false
 show_hidden_files = false
 
+# Auto-refresh interval in seconds (0 = disabled)
+# Periodically refreshes git status in the background
+# Default: 30
+refresh_interval = 30
+
 # ============================================================================
 # Git Settings
 # ============================================================================
@@ -160,6 +165,13 @@ push_all = "p"          # Push all worktrees in current task
 pull_all = "P"          # Pull all worktrees in current task (shift+p)
 refresh = "r"           # Refresh git status
 
+# Claude Code integration
+open_claude_resume = "c"    # Resume Claude Code session in task directory
+open_claude_new = "C"       # Start new Claude Code session (shift+c)
+
+# Messages panel
+toggle_messages = "m"       # Show/hide the activity messages panel
+
 # Navigation
 focus_next = "tab"          # Switch to next panel
 focus_previous = "shift+tab" # Switch to previous panel
@@ -224,10 +236,11 @@ tasks_dir = "/Volumes/FastSSD/worktrees"
 
 ## UI Settings
 
-| Option              | Type    | Default         | Environment Variable  | Description                     |
-|--------------------|---------|-----------------|-----------------------|---------------------------------|
-| `theme`            | string  | `textual-dark`  | `TASKTREE_THEME`     | Color theme for the interface   |
-| `show_hidden_files` | boolean | `false`         | -                     | Show hidden files in listings   |
+| Option              | Type    | Default         | Environment Variable  | Description                              |
+|--------------------|---------|-----------------|-----------------------|------------------------------------------|
+| `theme`            | string  | `textual-dark`  | `TASKTREE_THEME`     | Color theme for the interface            |
+| `show_hidden_files` | boolean | `false`         | -                     | Show hidden files in listings            |
+| `refresh_interval`  | integer | `30`            | -                     | Auto-refresh interval in seconds (0 = disabled) |
 
 ### `theme`
 
@@ -245,6 +258,20 @@ Available themes (press `Ctrl+P` in app to switch):
 
 Currently unused (reserved for future file browser features).
 
+### `refresh_interval`
+
+Automatically refreshes git status for all tasks and worktrees in the background:
+
+- Default: `30` (every 30 seconds)
+- Set to `0` to disable auto-refresh
+- Runs in a background thread — does not block the UI
+- Preserves current task and worktree selection during refresh
+
+```toml
+[ui]
+refresh_interval = 15  # Refresh every 15 seconds
+```
+
 ## Git Settings
 
 | Option                | Type    | Default | Environment Variable      | Description                              |
@@ -390,7 +417,7 @@ blocklist = ["*"]
 
 ## Keybindings Reference
 
-All 18 customizable keybindings with descriptions:
+All 21 customizable keybindings with descriptions:
 
 ### Application Control
 
@@ -419,6 +446,14 @@ All 18 customizable keybindings with descriptions:
 | `pull_all`     | `P`      | Pull all worktrees in current task    | `pull_all = "ctrl+shift+p"` |
 | `refresh`      | `r`      | Refresh git status for all worktrees  | `refresh = "F5"`            |
 
+### Claude Code Integration
+
+| Action               | Default | Description                              | Customization Example                |
+|----------------------|---------|------------------------------------------|--------------------------------------|
+| `open_claude_resume` | `c`     | Resume Claude Code session in task dir   | `open_claude_resume = "ctrl+c"`      |
+| `open_claude_new`    | `C`     | Start new Claude Code session            | `open_claude_new = "ctrl+shift+c"`   |
+| `toggle_messages`    | `m`     | Show/hide activity messages panel        | `toggle_messages = "ctrl+m"`         |
+
 ### Navigation
 
 | Action            | Default     | Description                    | Customization Example            |

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/docs/user-guide.md

@@ -60,7 +60,7 @@ Task: FEAT-123
 ```
 
 **Characteristics:**
-- Created with a unique name (e.g., `FEAT-123`, `DIC-1813-auth`)
+- Created with a unique name (e.g., `FEAT-123`, `BUG-456-auth`)
 - Contains one or more worktrees
 - Stored in `TASKS_DIR/task-name/`
 - Each task gets its own set of branches across selected repos
@@ -177,7 +177,9 @@ Shows all your tasks:
 
 - **Name**: Task identifier (e.g., `FEAT-123`)
 - **Count**: Number of worktrees in parentheses (e.g., `(3)`)
-- **Dirty indicator** `●`: Task has uncommitted changes
+- **Dirty indicator** `●`: Red dot — task has uncommitted changes
+- **CLAUDE.md indicator** `◆`: Blue diamond — task has a CLAUDE.md file
+- **Claude session status**: `⟳` running (magenta), `!` waiting (yellow), `✓` ended (green)
 - **Sort mode**: Press `s` to cycle through sort modes (name ↑/↓, date ↑/↓, dirty/clean first)
 
 **Navigation:**
@@ -221,13 +223,24 @@ Shows detailed git status for the selected worktree:
 
 ### Visual Indicators
 
+**Task & Worktree Status:**
+
 | Indicator | Meaning                                    |
 |-----------|--------------------------------------------|
-| `●`       | Task has uncommitted changes              |
-| `✗ N`     | N files staged or modified                |
-| `↑N`      | N commits ahead of remote (unpushed)      |
-| `↓N`      | N commits behind remote (need to pull)    |
-| `✓`       | Clean worktree, in sync                   |
+| `●`       | Task/worktree has uncommitted changes      |
+| `✗ N`     | N files staged or modified                 |
+| `↑N`      | N commits ahead of remote (unpushed)       |
+| `↓N`      | N commits behind remote (need to pull)     |
+| `✓`       | Clean worktree, in sync                    |
+
+**Claude Code Integration:**
+
+| Indicator | Color   | Meaning                                  |
+|-----------|---------|------------------------------------------|
+| `◆`       | Blue    | Task/worktree has a CLAUDE.md file       |
+| `⟳`       | Magenta | Claude Code session is running           |
+| `!`       | Yellow  | Claude Code session is waiting for input |
+| `✓`       | Green   | Claude Code session has ended            |
 
 ## Complete Keyboard Reference
 
@@ -318,12 +331,26 @@ All keybindings can be customized in [`config.toml`](configuration.md).
 - When focused on task list: Opens the task folder (`~/tasks/TASK-NAME`)
 - When focused on worktree list: Opens the selected worktree folder
 
+### Claude Code Integration
+
+| Key     | Action                  | Description                                  |
+|---------|-------------------------|----------------------------------------------|
+| `c`     | Open Claude (resume)    | Resume Claude Code session in task directory |
+| `C`     | Open Claude (new)       | Start new Claude Code session in task directory |
+
+**How it works:**
+- Opens Claude Code in a new Ghostty terminal tab at the task directory
+- Generates `CLAUDE.md` files with task/worktree context
+- Installs hooks that report session status back to tasktree-manager
+- Session status (`⟳` running, `!` waiting, `✓` ended) appears next to the task name
+
 ### General
 
 | Key     | Action                  | Description                                  |
 |---------|-------------------------|----------------------------------------------|
 | `Ctrl+P`| Open Command Palette    | Switch themes and run commands               |
 | `o`     | Open folder             | Open current folder in new terminal tab      |
+| `m`     | Toggle messages         | Show/hide the activity messages panel        |
 | `?`     | Show help               | Display help modal with keybindings          |
 | `q`     | Quit                    | Exit tasktree-manager                        |
 
@@ -696,7 +723,7 @@ gh pr create --head FEAT-123
 ### Naming Conventions
 
 **Task names:**
-- Use issue tracker IDs: `JIRA-1234`, `DIC-1813`
+- Use issue tracker IDs: `JIRA-1234`, `PROJ-567`
 - Or descriptive names: `feat-auth`, `bugfix-login`, `refactor-api`
 - Avoid spaces: Use `-` or `_`
 - Keep short but meaningful

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/pyproject.toml

@@ -70,7 +70,7 @@ version-file = "tasktree_manager/_version.py"
 # Semantic Release Configuration
 [tool.semantic_release]
 version_toml = ["pyproject.toml:tool.semantic_release.version"]
-version = "2.0.1"
+version = "2.2.0"
 tag_format = "v{version}"
 branch = "main"
 commit_message = "chore(release): {version} [skip ci]"

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '2.0.1'
-__version_tuple__ = version_tuple = (2, 0, 1)
+__version__ = version = '2.2.0'
+__version_tuple__ = version_tuple = (2, 2, 0)
 
 __commit_id__ = commit_id = None

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/app.py

@@ -1,5 +1,6 @@
 """Main application for tasktree-manager."""
 
+import json
 import subprocess
 
 from textual import work
@@ -8,6 +9,7 @@ from textual.binding import Binding
 from textual.containers import Horizontal, Vertical
 from textual.widgets import Footer, Header, Static
 
+from .services.claude_hooks import ensure_claude_hooks
 from .services.config import Config
 from .services.git_ops import GitOps
 from .services.models import GitStatus, Task, Worktree
@@ -141,7 +143,7 @@ class TaskTreeApp(App):
     /* Status panel styling */
     #status-display {
         height: 100%;
-        padding: 0 1;
+        padding: 1 1 0 1;
         background: $background;
         color: $text;
         overflow-y: auto;
@@ -250,6 +252,8 @@ class TaskTreeApp(App):
         self._show_messages_panel: bool = False
         # Used to preserve worktree selection during task list reload
         self._preserved_worktree_name: str | None = None
+        # Claude session statuses: task_name -> status string
+        self._claude_statuses: dict[str, str] = {}
 
     def _build_bindings_from_config(self) -> list[Binding]:
         """Build keybindings list from config.
@@ -306,6 +310,7 @@ class TaskTreeApp(App):
             # Right column: Info/Status panel
             with Vertical(id="right-column"):
                 with Vertical(id="status-panel"):
+                    yield Static("Info", classes="panel-title", id="status-panel-title")
                     yield StatusPanel(id="status-display")
                 with Vertical(id="messages-panel"):
                     yield MessagesPanel(id="messages-display")
@@ -330,6 +335,13 @@ class TaskTreeApp(App):
             task_list = self.query_one("#task-list", TaskList)
             task_list.focus()
 
+        # Poll Claude session status files every 5 seconds
+        self.set_interval(5, self._poll_claude_statuses)
+
+        # Periodic auto-refresh of git status
+        if self.config.refresh_interval > 0:
+            self.set_interval(self.config.refresh_interval, self._periodic_git_refresh)
+
     def watch_theme(self, theme: str) -> None:
         """Save theme to config when changed."""
         if hasattr(self, "config") and self.config.theme != theme:
@@ -420,6 +432,62 @@ class TaskTreeApp(App):
         finally:
             task_list.loading = False
 
+    def _poll_claude_statuses(self) -> None:
+        """Check .claude_status files and update task indicators."""
+        try:
+            task_list = self.query_one("#task-list", TaskList)
+        except Exception:
+            return
+
+        statuses: dict[str, str] = {}
+        for task in task_list.tasks:
+            status_file = task.path / ".claude_status"
+            if status_file.exists():
+                try:
+                    data = json.loads(status_file.read_text())
+                    statuses[task.name] = data.get("status", "unknown")
+                except (json.JSONDecodeError, OSError):
+                    pass
+
+        if statuses != self._claude_statuses:
+            self._claude_statuses = statuses
+            task_list.refresh_claude_indicators(statuses)
+
+    def _periodic_git_refresh(self) -> None:
+        """Trigger a background git status refresh."""
+        self._run_periodic_refresh()
+
+    @work(thread=True, exclusive=True, group="auto_refresh")
+    def _run_periodic_refresh(self) -> None:
+        """Refresh git status in background thread."""
+        tasks = self.task_manager.list_tasks()
+        all_worktrees = [wt for task in tasks for wt in task.worktrees]
+        GitOps.update_all_worktree_statuses(all_worktrees)
+
+        current_task_name = self.current_task.name if self.current_task else None
+        current_worktree_name = self.current_worktree.name if self.current_worktree else None
+
+        def _apply():
+            try:
+                task_list = self.query_one("#task-list", TaskList)
+                if current_worktree_name:
+                    self._preserved_worktree_name = current_worktree_name
+                task_list.load_tasks(tasks, preserve_selection=current_task_name)
+
+                if self.current_task:
+                    for t in tasks:
+                        if t.name == self.current_task.name:
+                            self.current_task = t
+                            worktree_list = self.query_one("#worktree-list", WorktreeList)
+                            worktree_list.load_worktrees(
+                                t.worktrees, preserve_selection=current_worktree_name
+                            )
+                            break
+            except Exception:
+                pass
+
+        self.call_from_thread(_apply)
+
     def _refresh_current_task(self, preserve_selection: bool = False) -> None:
         """Refresh the current task's worktrees and status.
 
@@ -469,6 +537,26 @@ class TaskTreeApp(App):
             self.notify(f"Failed to run {name}: {e}", severity="error")
             return False
 
+    def on_descendant_focus(self, event) -> None:
+        """Handle focus changes to update info panel mode."""
+        try:
+            status_panel = self.query_one("#status-display", StatusPanel)
+        except Exception:
+            return
+
+        if isinstance(event.widget, TaskList):
+            # Task list focused → show task changed files
+            if self.current_task:
+                status_panel.set_loading(True)
+                self._update_task_summary(self.current_task)
+        elif isinstance(event.widget, WorktreeList):
+            # Worktree list focused → show worktree details
+            if self.current_worktree and self.current_status:
+                status_panel.update_status(self.current_worktree, self.current_status)
+            elif self.current_worktree:
+                status_panel.set_loading(True)
+                self._update_worktree_status(self.current_worktree)
+
     def on_task_list_task_highlighted(self, event: TaskList.TaskHighlighted) -> None:
         """Handle task highlight in task list."""
         self.current_task = event.task
@@ -484,6 +572,12 @@ class TaskTreeApp(App):
             preserved = self._preserved_worktree_name
             self._preserved_worktree_name = None  # Clear after use
             worktree_list.load_worktrees(event.task.worktrees, preserve_selection=preserved)
+
+            # Show task summary if task list is focused
+            task_list = self.query_one("#task-list", TaskList)
+            if task_list.has_focus:
+                status_panel.set_loading(True)
+                self._update_task_summary(event.task)
         else:
             worktree_list.clear_worktrees()
             status_panel.clear_status()
@@ -499,12 +593,19 @@ class TaskTreeApp(App):
             # Widget not mounted yet during app startup
             return
 
+        # Only update status panel if worktree list is focused
+        worktree_list = self.query_one("#worktree-list", WorktreeList)
         if event.worktree:
-            status_panel.set_loading(True)
-            self._update_worktree_status(event.worktree)
+            if worktree_list.has_focus:
+                status_panel.set_loading(True)
+                self._update_worktree_status(event.worktree)
+            else:
+                # Still fetch status in background for when user switches focus
+                self._update_worktree_status(event.worktree)
         else:
             self.current_status = None
-            status_panel.clear_status()
+            if worktree_list.has_focus:
+                status_panel.clear_status()
 
     @work(thread=True, exclusive=True, group="status_update")
     def _update_worktree_status(self, worktree: Worktree) -> None:
@@ -520,7 +621,31 @@ class TaskTreeApp(App):
             self.current_status = status
             try:
                 status_panel = self.query_one("#status-display", StatusPanel)
-                status_panel.update_status(worktree, status)
+                # Only show worktree status if worktree list is focused
+                worktree_list = self.query_one("#worktree-list", WorktreeList)
+                if worktree_list.has_focus:
+                    status_panel.update_status(worktree, status)
+            except Exception:
+                pass
+
+    @work(thread=True, exclusive=True, group="task_summary_update")
+    def _update_task_summary(self, task: Task) -> None:
+        """Fetch git status for all dirty worktrees in background thread."""
+        statuses: dict[str, GitStatus] = {}
+        for wt in task.worktrees:
+            if wt.is_dirty:
+                statuses[wt.name] = GitOps.get_status(wt)
+        self.call_from_thread(self._apply_task_summary, task, statuses)
+
+    def _apply_task_summary(self, task: Task, statuses: dict[str, GitStatus]) -> None:
+        """Apply fetched task summary to the UI (called on main thread)."""
+        # Only update if this task is still selected and task list is focused
+        if self.current_task and self.current_task.name == task.name:
+            try:
+                status_panel = self.query_one("#status-display", StatusPanel)
+                task_list = self.query_one("#task-list", TaskList)
+                if task_list.has_focus:
+                    status_panel.update_task_summary(task, statuses)
             except Exception:
                 pass
 
@@ -607,8 +732,8 @@ class TaskTreeApp(App):
                     except Exception as e:
                         failed.append((repo, e))
 
-                self._load_tasks()
-                self._refresh_current_task()
+                self._load_tasks(preserve_selection=True)
+                self._refresh_current_task(preserve_selection=True)
 
                 if added:
                     self.notify(f"Added {len(added)} repo(s) to task")
@@ -918,7 +1043,7 @@ class TaskTreeApp(App):
             self.query_one("#worktree-list", WorktreeList).focus()
 
     def action_open_claude_resume(self) -> None:
-        """Open Claude Code with session list (claude -r) in the current task folder."""
+        """Open Claude Code in a new Ghostty tab (resume session)."""
         if not self.current_task:
             self.notify("No task selected", severity="warning")
             return
@@ -928,30 +1053,17 @@ class TaskTreeApp(App):
             self.notify("Task directory not found", severity="error")
             return
 
-        saved_task_name = self.current_task.name
-        saved_worktree_name = self.current_worktree.name if self.current_worktree else None
-
         # Fetch fresh task data to ensure worktrees are up-to-date
-        fresh_task = self.task_manager.get_task(saved_task_name)
+        fresh_task = self.task_manager.get_task(self.current_task.name)
         if fresh_task:
-            # Create claude.md files if they don't exist
             self.task_manager.ensure_claude_md_files(fresh_task)
 
-        self.notify("Opening Claude Code (resume)...")
-
-        with self.suspend():
-            self._run_external_command(
-                [self.config.claude_path, "-r"],
-                cwd=task_path,
-                name="Claude Code",
-                install_hint="npm install -g @anthropic-ai/claude-code",
-            )
-
-        self._load_tasks_with_selection(saved_task_name, saved_worktree_name)
-        self.query_one("#task-list", TaskList).focus()
+        ensure_claude_hooks(task_path)
+        self._open_ghostty_tab(task_path, command=f"{self.config.claude_path} -r")
+        self.notify("Opened Claude Code in new tab (resume)")
 
     def action_open_claude_new(self) -> None:
-        """Open a new Claude Code session in the current task folder."""
+        """Open a new Claude Code session in a new Ghostty tab."""
         if not self.current_task:
             self.notify("No task selected", severity="warning")
             return
@@ -961,27 +1073,14 @@ class TaskTreeApp(App):
             self.notify("Task directory not found", severity="error")
             return
 
-        saved_task_name = self.current_task.name
-        saved_worktree_name = self.current_worktree.name if self.current_worktree else None
-
         # Fetch fresh task data to ensure worktrees are up-to-date
-        fresh_task = self.task_manager.get_task(saved_task_name)
+        fresh_task = self.task_manager.get_task(self.current_task.name)
         if fresh_task:
-            # Create claude.md files if they don't exist
             self.task_manager.ensure_claude_md_files(fresh_task)
 
-        self.notify("Opening new Claude Code session...")
-
-        with self.suspend():
-            self._run_external_command(
-                [self.config.claude_path],
-                cwd=task_path,
-                name="Claude Code",
-                install_hint="npm install -g @anthropic-ai/claude-code",
-            )
-
-        self._load_tasks_with_selection(saved_task_name, saved_worktree_name)
-        self.query_one("#task-list", TaskList).focus()
+        ensure_claude_hooks(task_path)
+        self._open_ghostty_tab(task_path, command=self.config.claude_path)
+        self.notify("Opened new Claude Code session in new tab")
 
     def action_open_folder(self) -> None:
         """Open current folder in a new terminal tab."""
@@ -1006,15 +1105,23 @@ class TaskTreeApp(App):
         # Open in new terminal tab
         self._open_ghostty_tab(folder_path)
 
-    def _open_ghostty_tab(self, path) -> None:
-        """Open a new terminal tab at the given path.
+    def _open_ghostty_tab(self, path, command: str | None = None) -> None:
+        """Open a new terminal tab at the given path, optionally running a command.
 
         NOTE: This implementation is specific to the Ghostty terminal emulator
         on macOS, using AppleScript. It will silently fail on other terminals.
+
+        Args:
+            path: Directory to cd into in the new tab
+            command: Optional command to run after cd (e.g., "claude -r")
         """
         # Ghostty: Use AppleScript to activate and open new tab, then cd
         # Escape single quotes for AppleScript string interpolation
         safe_path = str(path).replace("'", "'\\''")
+        if command:
+            shell_cmd = f"cd '{safe_path}' && clear && {command}"
+        else:
+            shell_cmd = f"cd '{safe_path}' && clear"
         script = f"""
         tell application "Ghostty"
             activate
@@ -1023,7 +1130,7 @@ class TaskTreeApp(App):
             tell process "Ghostty"
                 keystroke "t" using command down
                 delay 0.1
-                keystroke "cd '{safe_path}' && clear"
+                keystroke "{shell_cmd}"
                 key code 36
             end tell
         end tell
@@ -1061,7 +1168,7 @@ class TaskTreeApp(App):
                     task_name,
                 )
 
-            self._refresh_current_task()
+            self._refresh_current_task(preserve_selection=True)
         finally:
             worktree_list.loading = False
 
@@ -1096,14 +1203,14 @@ class TaskTreeApp(App):
                     task_name,
                 )
 
-            self._refresh_current_task()
+            self._refresh_current_task(preserve_selection=True)
         finally:
             worktree_list.loading = False
 
     def action_refresh(self) -> None:
         """Refresh all status."""
-        self._load_tasks()
-        self._refresh_current_task()
+        self._load_tasks(preserve_selection=True)
+        self._refresh_current_task(preserve_selection=True)
         self.notify("Refreshed")
 
     def action_toggle_messages(self) -> None:

tasktree_manager-2.2.0/tasktree_manager/services/claude_hooks.py

@@ -0,0 +1,50 @@
+"""Claude Code hook configuration for status monitoring."""
+
+import json
+from pathlib import Path
+
+
+def _make_hook(status: str, status_file: str) -> dict:
+    """Create a single hook entry that writes status to the given file path."""
+    safe_path = status_file.replace("'", "'\\''")
+    return {
+        "type": "command",
+        "command": f'printf \'{{"status":"{status}","ts":%d}}\' $(date +%s) > \'{safe_path}\'',
+        "async": True,
+    }
+
+
+def _build_hooks_config(task_path: Path) -> dict:
+    """Build hooks config with absolute path to status file."""
+    status_file = str(task_path / ".claude_status")
+    return {
+        "SessionStart": [{"hooks": [_make_hook("running", status_file)]}],
+        "UserPromptSubmit": [{"hooks": [_make_hook("running", status_file)]}],
+        "Stop": [{"hooks": [_make_hook("waiting", status_file)]}],
+        "SessionEnd": [{"hooks": [_make_hook("ended", status_file)]}],
+    }
+
+
+def ensure_claude_hooks(task_path: Path) -> None:
+    """Create .claude/settings.local.json with status-reporting hooks.
+
+    Merges with existing settings if the file already exists, preserving
+    user's own configuration while adding/updating the status hooks.
+    """
+    claude_dir = task_path / ".claude"
+    claude_dir.mkdir(exist_ok=True)
+
+    settings_file = claude_dir / "settings.local.json"
+
+    if settings_file.exists():
+        try:
+            existing = json.loads(settings_file.read_text())
+        except (json.JSONDecodeError, OSError):
+            existing = {}
+    else:
+        existing = {}
+
+    # Merge hooks into existing settings
+    existing["hooks"] = _build_hooks_config(task_path)
+
+    settings_file.write_text(json.dumps(existing, indent=2) + "\n")

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/services/config.py

@@ -59,6 +59,7 @@ class Config:
     # UI settings
     theme: str = "textual-dark"
     show_hidden_files: bool = False
+    refresh_interval: int = 30  # Auto-refresh interval in seconds (0 = disabled)
 
     # Git settings
     default_base_branch: str = "main"
@@ -103,7 +104,8 @@ class Config:
         Priority: Environment variables > Config file > Defaults
         """
         config_dir = (
-            Path(os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config"))) / "tasktree-manager"
+            Path(os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config")))
+            / "tasktree-manager"
         )
         config_file = config_dir / "config.toml"
 
@@ -122,6 +124,7 @@ class Config:
         ui_config = config_data.get("ui", {})
         theme = ui_config.get("theme", "textual-dark")
         show_hidden_files = ui_config.get("show_hidden_files", False)
+        refresh_interval = ui_config.get("refresh_interval", 30)
 
         # Git settings
         git_config = config_data.get("git", {})
@@ -185,6 +188,7 @@ class Config:
             config_dir=config_dir,
             theme=theme,
             show_hidden_files=show_hidden_files,
+            refresh_interval=refresh_interval,
             default_base_branch=default_base_branch,
             auto_push=auto_push,
             git_timeout=git_timeout,
@@ -286,6 +290,9 @@ theme = "{self._toml_escape(self.theme)}"
 # Show hidden files in file listings
 show_hidden_files = {str(self.show_hidden_files).lower()}
 
+# Auto-refresh interval in seconds (0 = disabled)
+refresh_interval = {self.refresh_interval}
+
 # ============================================================================
 # Git Settings
 # ============================================================================

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/services/git_ops.py

@@ -190,6 +190,13 @@ class GitOps:
             True if current branch is merged into base_branch, False otherwise.
         """
         try:
+            # Fetch latest remote refs so we detect merges done via GitLab/GitHub UI
+            subprocess.run(
+                ["git", "fetch", "origin", base_branch],
+                cwd=worktree.path,
+                capture_output=True,
+                timeout=10,
+            )
             # Use git merge-base --is-ancestor to check if HEAD is reachable from base
             # This checks if the current branch has been merged
             result = subprocess.run(

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/widgets/status_panel.py

@@ -3,19 +3,23 @@
 from rich.text import Text
 from textual.widgets import Static
 
-from ..services.models import GitStatus, Worktree
+from ..services.models import GitStatus, Task, Worktree
 
 
 class StatusPanel(Static):
-    """Panel displaying git status for selected worktree."""
+    """Panel displaying git status for selected worktree or task summary."""
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
         self._worktree_name: str = ""
         self._status: GitStatus | None = None
+        self._current_task: Task | None = None
+        self._task_statuses: dict[str, GitStatus] = {}
+        self._mode: str = "worktree"  # "worktree" or "task"
 
     def update_status(self, worktree: Worktree | None, status: GitStatus | None) -> None:
         """Update the status display for a worktree."""
+        self._mode = "worktree"
         if worktree is None or status is None:
             self._worktree_name = ""
             self._status = None
@@ -26,8 +30,69 @@ class StatusPanel(Static):
         self._status = status
         self._update_display()
 
+    def update_task_summary(
+        self, task: Task | None, statuses: dict[str, GitStatus] | None = None
+    ) -> None:
+        """Update the display with a task summary.
+
+        Args:
+            task: The task to display
+            statuses: Optional dict of worktree_name -> GitStatus with file details
+        """
+        self._mode = "task"
+        self._current_task = task
+        self._task_statuses = statuses or {}
+        self._update_display()
+
     def _update_display(self) -> None:
         """Update the display content."""
+        if self._mode == "task":
+            self._render_task_summary()
+        else:
+            self._render_worktree_status()
+
+    def _render_task_summary(self) -> None:
+        """Render the task summary view — changed files grouped by repo."""
+        if self._current_task is None:
+            self.update(Text("No task selected", style="dim"))
+            return
+
+        task = self._current_task
+        text = Text()
+
+        dirty_worktrees = [wt for wt in task.worktrees if wt.is_dirty]
+
+        if not dirty_worktrees:
+            text.append("All repos clean", style="green")
+            self.update(text)
+            return
+
+        for wt in dirty_worktrees:
+            # Repo header
+            text.append(f"{wt.name}", style="bold")
+            text.append("\n")
+
+            status = self._task_statuses.get(wt.name)
+            if status:
+                for status_code, filename in status.all_changes:
+                    if status_code.strip().startswith("?"):
+                        text.append(f" {status_code} ", style="red")
+                        text.append(f"{filename}\n", style="red")
+                    elif status_code.strip().startswith("M") or status_code.strip() == "M":
+                        text.append(f" {status_code} ", style="yellow")
+                        text.append(f"{filename}\n")
+                    else:
+                        text.append(f" {status_code} ", style="green")
+                        text.append(f"{filename}\n")
+            else:
+                text.append(f"  {wt.changed_files} files changed\n", style="dim italic")
+
+            text.append("\n")
+
+        self.update(text)
+
+    def _render_worktree_status(self) -> None:
+        """Render the worktree-specific status view."""
         if not self._worktree_name or self._status is None:
             self.update(Text("No worktree selected", style="dim"))
             return
@@ -81,6 +146,8 @@ class StatusPanel(Static):
         """Clear the status display."""
         self._worktree_name = ""
         self._status = None
+        self._current_task = None
+        self._mode = "worktree"
         self.update(Text("No worktree selected", style="dim"))
 
     def set_loading(self, loading: bool = True) -> None:

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/widgets/task_list.py

@@ -60,27 +60,42 @@ class TaskList(OptionList):
         """Compatibility property - sets highlighted index."""
         self.highlighted = value
 
-    def _format_task_option(self, task: Task) -> Option:
+    def _format_task_option(self, task: Task, claude_status: str | None = None) -> Option:
         """Format a task as an Option for display."""
-        claude_indicator = "[blue]◆[/]" if task.has_claude_md else " "
+        claude_md = "[blue]◆[/]" if task.has_claude_md else " "
+        if claude_status == "running":
+            hook_indicator = " [magenta]⟳[/]"
+        elif claude_status == "waiting":
+            hook_indicator = " [yellow]![/]"
+        elif claude_status == "ended":
+            hook_indicator = " [green]✓[/]"
+        else:
+            hook_indicator = ""
         if task.is_dirty:
-            prompt = f"[red]●[/]{claude_indicator}{task.name} [red]({task.dirty_count})[/]"
+            prompt = f"[red]●[/]{claude_md}{task.name} [red]({task.dirty_count})[/]{hook_indicator}"
         else:
-            prompt = f"  {claude_indicator}{task.name}"
+            prompt = f"  {claude_md}{task.name}{hook_indicator}"
         return Option(prompt, id=task.name)
 
-    def load_tasks(self, tasks: list[Task], preserve_selection: str | None = None) -> None:
+    def load_tasks(
+        self,
+        tasks: list[Task],
+        preserve_selection: str | None = None,
+        claude_statuses: dict[str, str] | None = None,
+    ) -> None:
         """Load tasks into the list.
 
         Args:
             tasks: List of tasks to load
             preserve_selection: Optional task name to preserve selection for
+            claude_statuses: Optional dict of task_name -> claude status string
         """
         sorted_tasks = self._sort_tasks(tasks)
         self.tasks = sorted_tasks
         self.clear_options()
+        statuses = claude_statuses or {}
         for task in sorted_tasks:
-            self.add_option(self._format_task_option(task))
+            self.add_option(self._format_task_option(task, statuses.get(task.name)))
 
         # Select item - preserve previous selection if specified
         if self.tasks and self.option_count > 0:
@@ -131,6 +146,15 @@ class TaskList(OptionList):
             self.highlighted = current_index
             self._emit_highlighted()
 
+    def refresh_claude_indicators(self, statuses: dict[str, str]) -> None:
+        """Update Claude status indicators without full reload.
+
+        Re-renders all option labels with updated claude status indicators.
+        """
+        for i, task in enumerate(self.tasks):
+            new_option = self._format_task_option(task, statuses.get(task.name))
+            self.replace_option_prompt_at_index(i, new_option.prompt)
+
     def cycle_sort_mode(self) -> None:
         """Cycle through sort modes and reload tasks."""
         modes = list(SortMode)

{tasktree_manager-2.0.1 → tasktree_manager-2.2.0}/tasktree_manager/widgets/worktree_list.py

@@ -140,9 +140,9 @@ class WorktreeList(OptionList):
         claude_indicator = "[blue]◆[/]" if worktree.has_claude_md else " "
 
         if worktree.is_dirty:
-            prompt = f" {claude_indicator}{name_col}  [cyan]{branch_col}[/]  [red]✗ {worktree.changed_files} files[/]"
+            prompt = f" {claude_indicator}{name_col}  {branch_col}  [red]✗ {worktree.changed_files} files[/]"
         else:
-            prompt = f" {claude_indicator}{name_col}  [cyan]{branch_col}[/]  [green]✓[/]"
+            prompt = f" {claude_indicator}{name_col}  {branch_col}  [green]✓[/]"
         self.add_option(Option(prompt, id=worktree.name))
 
     def _emit_highlighted(self) -> None: