tasktree-manager 2.5.0__tar.gz → 2.7.0__tar.gz

{tasktree_manager-2.5.0 → tasktree_manager-2.7.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.7.0] - 2026-07-13
+
+### Added
+- **ui**: Design-system themes, layered panels, theme cycling
+
+### Fixed
+- **claude**: Copy repo CLAUDE.md into worktrees instead of stub
+- **worktree**: Base new worktrees on origin base branch
+
+
+## [2.6.0] - 2026-07-13
+
+### Changed
+- Hunk diff viewer, shared Claude memory pool, repo filter fix (#8)
+
+
 ## [2.5.0] - 2026-06-10
 
 ### Added

{tasktree_manager-2.5.0 → tasktree_manager-2.7.0}/PKG-INFO

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

{tasktree_manager-2.5.0 → tasktree_manager-2.7.0}/README.md

@@ -14,7 +14,7 @@
 - 🌳 **Git Worktree Management** - Create, delete, and manage worktrees seamlessly
 - 📊 **Real-Time Status** - See uncommitted changes, branch info, and sync status at a glance
 - 🔀 **Sorting & Grouping** - Sort tasks by name/date/status, group worktrees by dirty/clean
-- 🎨 **Beautiful Themes** - 7 built-in themes via Command Palette (Ctrl+P)
+- 🎨 **Beautiful Themes** - lazygit-inspired default plus 20+ themes (Catppuccin, Tokyo Night, Nord, ...) via Command Palette (Ctrl+P)
 - ⌨️ **Keyboard-First** - Navigate and control everything without touching the mouse
 - 🚀 **Fast & Responsive** - Parallel git operations with loading indicators
 - 🔧 **Flexible Configuration** - TOML config file, custom keybindings, environment variables
@@ -57,8 +57,9 @@ On first run, you'll configure:
 
 1. **Create a task** - Press `n`, enter task name, select repositories
 2. **Work on code** - Press `e` for editor, `g` for lazygit, or `Enter` for shell
-3. **Push changes** - Press `p` to push all worktrees
-4. **Delete task** - Press `d` when finished
+3. **Review changes** - Press `h` to view the diff in [hunk](https://github.com/modem-dev/hunk) (all repos from the task panel, one repo from the worktree panel)
+4. **Push changes** - Press `p` to push all worktrees
+5. **Delete task** - Press `d` when finished
 
 For detailed workflows and examples, see the [User Guide](docs/user-guide.md).
 
@@ -75,16 +76,17 @@ For detailed workflows and examples, see the [User Guide](docs/user-guide.md).
 | Key | Action | Key | Action |
 |-----|--------|-----|--------|
 | `n` | New task | `g` | Open lazygit |
-| `a` | Add repo | `e` | Open editor |
-| `d` | Delete task | `o` | Open folder |
-| `p` | Push all | `P` | Pull all |
+| `a` | Add repo | `h` | Show diff (hunk) |
+| `d` | Delete task | `e` | Open editor |
+| `p` | Push all | `o` | Open folder |
+| `P` | Pull all | `Enter` | Open shell |
 | `c` | Claude (resume) | `C` | Claude (new) |
 | `r` | Refresh | `s` | Sort tasks |
 | `S` | Group worktrees | `m` | Messages |
-| `Enter` | Open shell | `Tab` | Next panel |
+| `t` | Cycle theme | `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).
+**Themes:** The default `tasktree` theme pairs a lazygit-classic ANSI palette with layered panels, numbered title bars, green focus borders, and a keycap footer. Five more design-system palettes ship tuned to the same shape — tokyo-night, catppuccin-mocha, gruvbox, dracula, nord — and every other Textual built-in theme works too (`Ctrl+P` to switch); the whole UI is styled with Textual design tokens, so any theme restyles it consistently.
 
 ## 🏗️ How It Works
 

{tasktree_manager-2.5.0 → tasktree_manager-2.7.0}/docs/configuration.md

@@ -85,9 +85,10 @@ tasks_dir = "/Users/username/tasks"
 [ui]
 
 # Theme to use for the interface
-# Options: textual-dark, textual-light, nord, gruvbox, tokyo-night, monokai, dracula
-# Default: textual-dark
-theme = "textual-dark"
+# Options: tasktree (default), tokyo-night, catppuccin-mocha, catppuccin-latte,
+# catppuccin-frappe, catppuccin-macchiato, nord, gruvbox, dracula, monokai,
+# rose-pine, textual-dark, textual-light, ...
+theme = "tasktree"
 
 # Show hidden files in file listings
 # Default: false
@@ -133,6 +134,25 @@ editor = ""
 # Default: "lazygit" (searches PATH)
 lazygit_path = "lazygit"
 
+# Path to hunk executable (terminal diff viewer)
+# https://github.com/modem-dev/hunk
+# Default: "hunk" (searches PATH)
+hunk_path = "hunk"
+
+# Path to claude CLI executable
+# Default: "claude" (searches PATH)
+claude_path = "claude"
+
+# Shared Claude Code auto-memory directory for task sessions.
+# Task folders are not git repositories, so by default Claude Code would key
+# its auto memory to the task path — memory that is orphaned when the task is
+# deleted. tasktree-manager writes this path as "autoMemoryDirectory" into each
+# task's .claude/settings.local.json so every task session reads and writes one
+# shared memory pool that persists across tasks.
+# Set to "" to disable (each task keeps its own throwaway memory).
+# Default: "~/.claude/tasktree-memory"
+claude_memory_dir = "~/.claude/tasktree-memory"
+
 # Preferred shell
 # Leave empty to use $SHELL environment variable
 # Default: "" (uses $SHELL, falls back to /bin/bash)
@@ -158,6 +178,7 @@ delete_task = "d"       # Delete/finish task
 
 # Git operations
 open_lazygit = "g"      # Open lazygit in selected worktree
+show_diff = "h"         # Open hunk diff (task panel = all repos, worktree panel = one repo)
 open_editor = "e"       # Open editor in selected task/worktree
 open_folder = "o"       # Open folder in new terminal tab
 open_shell = "enter"    # Open shell in selected worktree
@@ -182,6 +203,9 @@ cursor_up = "k"             # Move cursor up
 cycle_sort = "s"            # Cycle task sort mode
 toggle_grouping = "S"       # Toggle worktree grouping (shift+s)
 
+# Appearance
+cycle_theme = "t"           # Cycle through the design-system themes
+
 # ============================================================================
 # Symlinks
 # ============================================================================
@@ -238,7 +262,7 @@ tasks_dir = "/Volumes/FastSSD/worktrees"
 
 | Option              | Type    | Default         | Environment Variable  | Description                              |
 |--------------------|---------|-----------------|-----------------------|------------------------------------------|
-| `theme`            | string  | `textual-dark`  | `TASKTREE_THEME`     | Color theme for the interface            |
+| `theme`            | string  | `tasktree`      | `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) |
 
@@ -246,13 +270,21 @@ tasks_dir = "/Volumes/FastSSD/worktrees"
 
 Available themes (press `Ctrl+P` in app to switch):
 
-- `textual-dark` - Default dark theme with blue accents
-- `textual-light` - Light theme with high contrast
-- `nord` - Arctic, north-bluish color palette
-- `gruvbox` - Retro groove warm color scheme
-- `tokyo-night` - Clean, dark theme inspired by Tokyo's night
-- `monokai` - Classic dark theme with vibrant colors
-- `dracula` - Dark theme with pastel-like colors
+- `tasktree` - Default: lazygit-classic ANSI palette with green focus borders
+- `tokyo-night` - Blue accent on deep blue-black
+- `catppuccin-mocha` - Mauve accent, soothing pastels
+- `gruvbox` - Orange accent, retro warm
+- `dracula` - Purple accent, high-contrast pastels
+- `nord` - Frost cyan accent, arctic palette
+
+These six come from the tasktree design system, with matched panel layering
+and selection colors. All other Textual built-in themes also work
+(`catppuccin-latte`, `rose-pine`, `monokai`, `solarized-dark`,
+`textual-dark`/`-light`, ...).
+
+The whole UI is styled with Textual design tokens (panel surfaces, focus
+borders, selection bars, footer keycaps), so every theme restyles all of it
+consistently.
 
 ### `show_hidden_files`
 
@@ -305,6 +337,7 @@ refresh_interval = 15  # Refresh every 15 seconds
 |---------------|--------|-------------|---------------------|--------------------------------------|
 | `editor`      | string | `""`        | `EDITOR`            | Command to launch your editor        |
 | `lazygit_path` | string | `"lazygit"` | -                   | Path to lazygit executable           |
+| `hunk_path`   | string | `"hunk"`    | -                   | Path to hunk diff-viewer executable  |
 | `shell`       | string | `""`        | `SHELL`             | Shell to use when opening terminals  |
 
 ### Details
@@ -320,6 +353,13 @@ refresh_interval = 15  # Refresh every 15 seconds
 - Use absolute path for custom location: `"/opt/homebrew/bin/lazygit"`
 - Install lazygit: `brew install lazygit` (macOS), `apt install lazygit` (Ubuntu)
 
+**`hunk_path`:**
+- [hunk](https://github.com/modem-dev/hunk) is a review-first terminal diff viewer
+- Default `"hunk"` searches PATH
+- Use absolute path for custom location: `"/opt/homebrew/bin/hunk"`
+- Install hunk: `brew install hunk` (macOS) or `npm i -g hunkdiff`
+- Used when pressing `h`: from the task panel it opens a combined diff across all the task's repos; from the worktree panel it opens the selected repo's diff
+
 **`shell`:**
 - Leave empty (`""`) to use `$SHELL` environment variable
 - Fallback: `/bin/bash`
@@ -441,6 +481,7 @@ All 22 customizable keybindings with descriptions:
 | Action         | Default  | Description                           | Customization Example       |
 |----------------|----------|---------------------------------------|-----------------------------|
 | `open_lazygit` | `g`      | Open lazygit in selected worktree     | `open_lazygit = "ctrl+g"`   |
+| `show_diff`    | `h`      | Open hunk diff (task = all repos, worktree = one) | `show_diff = "ctrl+h"` |
 | `open_editor`  | `e`      | Open editor in task/worktree folder   | `open_editor = "ctrl+e"`    |
 | `open_folder`  | `o`      | Open folder in new terminal tab       | `open_folder = "ctrl+o"`    |
 | `open_shell`   | `enter`  | Open shell in selected worktree       | `open_shell = "ctrl+t"`     |
@@ -471,6 +512,7 @@ All 22 customizable keybindings with descriptions:
 |-------------------|---------|------------------------------------------|----------------------------------|
 | `cycle_sort`      | `s`     | Cycle task sort mode                     | `cycle_sort = "ctrl+s"`          |
 | `toggle_grouping` | `S`     | Toggle worktree grouping by dirty/clean  | `toggle_grouping = "ctrl+g"`     |
+| `cycle_theme`     | `t`     | Cycle through the design-system themes   | `cycle_theme = "ctrl+t"`         |
 
 ### Available Key Syntax
 
@@ -585,15 +627,14 @@ TASKTREE_THEME=dracula tasktree-manager
 
 ### Theme Descriptions
 
-| Theme           | Style               | Best For                          |
-|-----------------|---------------------|-----------------------------------|
-| `textual-dark`  | Dark with blue      | Default, general use              |
-| `textual-light` | Light with contrast | Bright environments               |
-| `nord`          | Arctic blue         | Low-contrast, easy on eyes        |
-| `gruvbox`       | Retro warm          | Nostalgic, comfortable            |
-| `tokyo-night`   | Modern dark         | Clean, professional               |
-| `monokai`       | Vibrant colors      | High contrast, code-focused       |
-| `dracula`       | Pastel dark         | Popular, easy to read             |
+| Theme                | Style               | Best For                          |
+|----------------------|---------------------|-----------------------------------|
+| `tasktree`           | Lazygit-style ANSI  | Default, terminal-native feel     |
+| `tokyo-night`        | Modern dark         | Clean, professional               |
+| `catppuccin-mocha`   | Soothing pastel     | Popular, easy on the eyes         |
+| `gruvbox`            | Retro warm          | Nostalgic, comfortable            |
+| `dracula`            | Pastel dark         | Popular, easy to read             |
+| `nord`               | Arctic blue         | Low-contrast, easy on eyes        |
 
 ### Theme Persistence
 

{tasktree_manager-2.5.0 → tasktree_manager-2.7.0}/docs/user-guide.md

@@ -134,17 +134,22 @@ A **worktree** is a git working directory for a specific repository within a tas
    - Stage files, commit changes, resolve conflicts
    - Exit lazygit (press `q` in lazygit)
 
-3. **Or open a shell:**
+3. **Review the diff:**
+   - Press `h` from the worktree panel to review that repo's changes in [hunk](https://github.com/modem-dev/hunk)
+   - Press `h` from the task panel to review a combined diff across **all** the task's repos at once
+   - Exit hunk (press `q`)
+
+4. **Or open a shell:**
    - Press `Enter` to open a shell in the worktree
    - Make changes with your editor/IDE
    - Run build/test commands
    - Exit shell (type `exit`)
 
-4. **Push changes:**
+5. **Push changes:**
    - Press `p` to push all worktrees in the task
    - Or use lazygit (`g`) to push individually
 
-5. **Delete the task:**
+6. **Delete the task:**
    - Press `d` to delete/finish the task
    - Follow prompts if there are uncommitted or unpushed changes
    - Worktrees are removed (branches remain on remote)
@@ -168,7 +173,7 @@ tasktree-manager uses a **3-panel layout**:
 │   M  src/auth.py                                                       │
 │   ?? README.md                                                         │
 └──────────────────────────────────────────────────────────────────────────┘
-  n New  d Delete  g Lazygit  p Push  r Refresh  ? Help  q Quit
+  n New  d Delete  g Lazygit  h Diff  p Push  r Refresh  ? Help  q Quit
 ```
 
 ### Left Panel: Task List
@@ -203,7 +208,7 @@ Shows worktrees for the selected task:
 
 **Navigation:**
 - `j/k` or arrow keys: Move up/down
-- `S`: Toggle grouping by dirty/clean (panel title shows "(grouped)" when active)
+- `S`: Toggle grouping by dirty/clean (panel subtitle shows "grouped" when active)
 - Highlighting a worktree: Shows detailed status in bottom panel
 
 ### Bottom Panel: Status Display
@@ -272,6 +277,7 @@ what is displayed. Press `?` for the full reference at any time.
 |-----|-----------------------|------------------------------------------------------------|
 | `s` | Cycle sort mode       | Cycle through: name ↑/↓, date ↑/↓, dirty first, clean first |
 | `S` | Toggle grouping       | Group worktrees by dirty/clean status (Shift+S)            |
+| `t` | Cycle theme           | Cycle tasktree → tokyo-night → catppuccin (4x) → gruvbox → dracula → nord |
 
 **Sort modes:**
 - `by name ↑` - Alphabetical A-Z (default)
@@ -325,6 +331,7 @@ Useful when you're spinning up several similar tasks that share the same set of
 | Key     | Action             | Description                                          |
 |---------|--------------------|------------------------------------------------------|
 | `g`     | Open lazygit       | Open lazygit in the selected worktree                |
+| `h`     | Show diff          | Open hunk: all repos from the task panel, the selected repo from the worktree panel |
 | `e`     | Open editor        | Open editor in task/worktree folder (runs `$EDITOR .`) |
 | `Enter` | Open shell         | Open a shell in the selected worktree                |
 | `p`     | Push all           | Push all worktrees in the current task (parallel)    |
@@ -357,8 +364,9 @@ Useful when you're spinning up several similar tasks that share the same set of
 - `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.
+- The CLI variant (`c`) generates a task-level `CLAUDE.md` with task/worktree context, copies each repo's own `CLAUDE.md` into worktrees whose branch predates it (never generating stub content), and installs hooks that report session status back to tasktree-manager.
 - Session status (`⟳` running, `!` waiting, `✓` ended) appears next to the task name
+- Both variants point the session's Claude Code auto-memory at a shared pool (`claude_memory_dir`, default `~/.claude/tasktree-memory`). Task folders are not git repos, so without this each task would get its own memory directory that is orphaned when the task is deleted; with the shared pool, what Claude learns in one task carries over to future tasks.
 
 ### General
 
@@ -666,6 +674,34 @@ apt install lazygit
 # See: https://github.com/jesseduffield/lazygit
 ```
 
+### Hunk
+
+[hunk](https://github.com/modem-dev/hunk) is a review-first terminal diff viewer, well suited to reviewing agent-authored changesets across a multi-repo task.
+
+**Why hunk:**
+- Fast, keyboard-driven diff review with a desktop-inspired layout
+- Reviews an entire task's changes across all its repos in one view
+- Complements lazygit (which stages/commits per repo)
+
+**Using hunk:**
+1. From the **worktree panel**, press `h` to review the selected repo's uncommitted changes
+2. From the **task panel**, press `h` to review a combined diff across **all** the task's repos at once (each file is grouped under its repo name)
+3. tasktree-manager suspends, hunk opens
+4. Press `q` in hunk to return; status auto-refreshes and selection is preserved
+
+The combined task view includes both tracked (staged and unstaged) changes and untracked files.
+
+**Install hunk:**
+```bash
+# macOS
+brew install hunk
+
+# npm
+npm i -g hunkdiff
+
+# See: https://github.com/modem-dev/hunk
+```
+
 ### Editors
 
 **Direct editor integration:**

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

{tasktree_manager-2.5.0 → tasktree_manager-2.7.0}/tasktree_manager/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.5.0'
-__version_tuple__ = version_tuple = (2, 5, 0)
+__version__ = version = '2.7.0'
+__version_tuple__ = version_tuple = (2, 7, 0)
 
 __commit_id__ = commit_id = None