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

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

@@ -15,6 +15,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Git hooks support
 - Custom task metadata
 
+## [2.3.0] - 2026-06-10
+
+### Added
+- Add task cloning, worktree deletion, and non-blocking git ops (#4)
+
+### Fixed
+- Honor git timeout, real status codes, non-blocking delete (#5)
+
+
+## [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.3.0}/PKG-INFO

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

{tasktree_manager-2.1.0 → tasktree_manager-2.3.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.3.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"    # Open Claude CLI (resume if a session exists, else new)
+open_claude_gui_code = "C"  # Open Claude desktop on Code page in task folder (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                              |
@@ -267,7 +294,8 @@ Currently unused (reserved for future file browser features).
 - Most users should use manual push (`p` key) for control
 
 **`timeout`:**
-- Timeout for git commands (clone, fetch, push, pull)
+- Timeout for git commands that touch the network (fetch, push, pull) and worktree creation
+- Local status queries use a fixed short timeout (5s) and are not affected
 - Increase for slow networks or large repositories
 - Set to `60` or higher for very large repos
 
@@ -390,7 +418,7 @@ blocklist = ["*"]
 
 ## Keybindings Reference
 
-All 18 customizable keybindings with descriptions:
+All 22 customizable keybindings with descriptions:
 
 ### Application Control
 
@@ -404,6 +432,7 @@ All 18 customizable keybindings with descriptions:
 | Action        | Default | Description                            | Customization Example      |
 |---------------|---------|----------------------------------------|----------------------------|
 | `new_task`    | `n`     | Create a new task                      | `new_task = "ctrl+n"`      |
+| `clone_task`  | `y`     | Clone current task (same repos, new name) | `clone_task = "ctrl+y"`  |
 | `add_repo`    | `a`     | Add repository to current task         | `add_repo = "ctrl+a"`      |
 | `delete_task` | `d`     | Delete/finish current task             | `delete_task = "delete"`   |
 
@@ -419,6 +448,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`     | Open Claude CLI (resume if session exists, else new) | `open_claude_resume = "ctrl+c"`      |
+| `open_claude_gui_code`| `C`     | Open Claude desktop on Code page in task folder      | `open_claude_gui_code = "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.3.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
 
@@ -272,6 +285,7 @@ All keybindings can be customized in [`config.toml`](configuration.md).
 | Key | Action           | Description                                               |
 |-----|------------------|-----------------------------------------------------------|
 | `n` | New task         | Create a new task with selected repositories              |
+| `y` | Clone task       | Create a new task pre-populated with the current task's repos |
 | `a` | Add repository   | Add additional repositories to the current task           |
 | `d` | Delete/finish    | Delete current task and remove worktrees                  |
 
@@ -283,6 +297,14 @@ All keybindings can be customized in [`config.toml`](configuration.md).
 5. Select repos with `Space` (can select multiple)
 6. Tab to "Create" button, press `Enter`
 
+**Clone task workflow:**
+Useful when you're spinning up several similar tasks that share the same set of repos.
+
+1. Highlight the source task in the left panel
+2. Press `y`
+3. The modal opens with the source task's repos already selected — just enter a new task name
+4. Adjust the repo selection or base branch if needed, then press `Enter`
+
 **Task deletion workflow:**
 1. Highlight task in left panel
 2. Press `d`
@@ -318,12 +340,27 @@ 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 CLI         | Resume the task's Claude Code session if one exists, otherwise start a new one |
+| `C`     | Open Claude desktop     | Open the Claude desktop app on the Code page at the task folder |
+
+**How it works:**
+- `c` opens Claude Code CLI in a new Ghostty terminal tab at the task directory.
+  - If `~/.claude/projects/<task-folder>/` already has session transcripts, runs `claude -r` to pick from them; otherwise runs `claude` to start fresh.
+- `C` opens the Claude desktop app via the `claude://code/new?folder=<task-folder>` URL scheme.
+- The CLI variant (`c`) generates `CLAUDE.md` files with task/worktree context and 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.3.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.3.0"
 tag_format = "v{version}"
 branch = "main"
 commit_message = "chore(release): {version} [skip ci]"

tasktree_manager-2.3.0/tasktree_manager/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '2.3.0'
+__version_tuple__ = version_tuple = (2, 3, 0)
+
+__commit_id__ = commit_id = None