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

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

@@ -15,6 +15,12 @@ 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

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

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

{tasktree_manager-2.1.0 → 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                                   │
-│  ● FEAT-42 (2)           │    web-api            FEAT-42          ✗ 3   │
-│    FEAT-38-auth          │    frontend           FEAT-42          ✓     │
-│                          │                                              │
-│                          │                                              │
-├──────────────────────────────────────────────────────────────────────────┤
-│  Status: web-api                                                         │
-│  Branch: FEAT-42                                                         │
-│  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.1.0 → 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.1.0 → tasktree_manager-2.2.0}/docs/user-guide.md

@@ -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                        |
 

{tasktree_manager-2.1.0 → 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.1.0"
+version = "2.2.0"
 tag_format = "v{version}"
 branch = "main"
 commit_message = "chore(release): {version} [skip ci]"

{tasktree_manager-2.1.0 → 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.1.0'
-__version_tuple__ = version_tuple = (2, 1, 0)
+__version__ = version = '2.2.0'
+__version_tuple__ = version_tuple = (2, 2, 0)
 
 __commit_id__ = commit_id = None

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

@@ -338,6 +338,10 @@ class TaskTreeApp(App):
         # 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:
@@ -449,6 +453,41 @@ class TaskTreeApp(App):
             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.
 
@@ -693,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")
@@ -1129,7 +1168,7 @@ class TaskTreeApp(App):
                     task_name,
                 )
 
-            self._refresh_current_task()
+            self._refresh_current_task(preserve_selection=True)
         finally:
             worktree_list.loading = False
 
@@ -1164,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.1.0 → tasktree_manager-2.2.0}/tasktree_manager/services/claude_hooks.py

@@ -9,7 +9,7 @@ def _make_hook(status: str, status_file: str) -> dict:
     safe_path = status_file.replace("'", "'\\''")
     return {
         "type": "command",
-        "command": f"printf '{{\"status\":\"{status}\",\"ts\":%d}}' $(date +%s) > '{safe_path}'",
+        "command": f'printf \'{{"status":"{status}","ts":%d}}\' $(date +%s) > \'{safe_path}\'',
         "async": True,
     }
 

{tasktree_manager-2.1.0 → 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.1.0 → 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(