tasktree-manager 2.11.1__tar.gz → 2.12.0__tar.gz

{tasktree_manager-2.11.1 → tasktree_manager-2.12.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.12.0] - 2026-07-31
+
+### Added
+- **tui**: Rename task display label with R
+
+
 ## [2.11.1] - 2026-07-31
 
 ### Fixed

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/PKG-INFO

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

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/README.md

@@ -113,6 +113,7 @@ a Claude Code statusline or shell prompt.
 | `r` | Refresh | `s` | Sort tasks |
 | `S` | Group worktrees | `m` | Messages |
 | `t` | Cycle theme | `Tab` | Next panel |
+| `R` | Rename task | | |
 | `?` | Show help | `q` | Quit |
 
 **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.

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/docs/configuration.md

@@ -223,6 +223,7 @@ help = "?"              # Show help modal
 new_task = "n"          # Create new task
 add_repo = "a"          # Add repository to current task
 delete_task = "d"       # Delete/finish task
+rename_task = "R"       # Rename task display label (folder/branch unchanged, shift+r)
 delete_worktree = "D"   # Remove single worktree from task (shift+d)
 
 # Git operations
@@ -583,6 +584,7 @@ All 22 customizable keybindings with descriptions:
 | `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"`   |
+| `rename_task` | `R`     | Rename task display label (alias only) | `rename_task = "ctrl+r"`   |
 
 ### Git Operations
 

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/docs/user-guide.md

@@ -300,6 +300,7 @@ what is displayed. Press `?` for the full reference at any time.
 | `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                  |
+| `R` | Rename task      | Set a display alias shown in the task list (folder/branch unchanged; empty input reverts) |
 
 **Task creation workflow:**
 1. Press `n`

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

{tasktree_manager-2.11.1 → tasktree_manager-2.12.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.11.1'
-__version_tuple__ = version_tuple = (2, 11, 1)
+__version__ = version = '2.12.0'
+__version_tuple__ = version_tuple = (2, 12, 0)
 
 __commit_id__ = commit_id = None

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/app.py

@@ -34,6 +34,7 @@ from .widgets.create_modal import (
     DispatchAgentModal,
     HelpModal,
     PushResultModal,
+    RenameTaskModal,
     SafeDeleteModal,
 )
 from .widgets.messages_panel import MessageLevel, MessagesPanel
@@ -274,6 +275,7 @@ class TaskTreeApp(App):
             Binding(kb.get("clone_task", "y"), "clone_task", "Clone", show=False),
             Binding(kb.get("add_repo", "a"), "add_repo", "Add Repo", show=False),
             Binding(kb.get("delete_task", "d"), "delete_task", "Delete", show=False),
+            Binding(kb.get("rename_task", "R"), "rename_task", "Rename", show=False),
             Binding(kb.get("open_lazygit", "g"), "open_lazygit", "Lazygit", show=False),
             Binding(kb.get("show_diff", "h"), "show_diff", "Diff", show=False),
             Binding(kb.get("open_editor", "e"), "open_editor", "Editor", show=False),
@@ -320,6 +322,7 @@ class TaskTreeApp(App):
             (kb.get("clone_task", "y"), "clone_task", "Clone"),
             (kb.get("add_repo", "a"), "add_repo", "Add Repo"),
             (kb.get("delete_task", "d"), "delete_task", "Delete"),
+            (kb.get("rename_task", "R"), "rename_task", "Rename"),
             (kb.get("show_diff", "h"), "show_diff", "Diff"),
             (kb.get("open_claude_resume", "c"), "open_claude_resume", "Claude"),
             (kb.get("cycle_sort", "s"), "cycle_sort", "Sort"),
@@ -1190,6 +1193,28 @@ class TaskTreeApp(App):
 
         self.push_screen(ConfirmModal(title, message), handle_confirm)
 
+    def action_rename_task(self) -> None:
+        """Set a display alias for the current task (folder/branch unchanged)."""
+        if not self.current_task:
+            self.notify("No task selected", severity="warning")
+            return
+        task = self.current_task
+
+        def handle_rename(new_name: str | None) -> None:
+            if new_name is None:
+                return
+            try:
+                self.task_manager.set_task_display_name(task, new_name)
+            except OSError as e:
+                self.notify(escape(f"Rename failed: {e}"), severity="error")
+                return
+            label = task.display_label
+            self.notify(escape(f"Task '{task.name}' shown as '{label}'"))
+            self._log_activity(f"Task '{task.name}' renamed to '{label}'", MessageLevel.INFO)
+            self._run_periodic_refresh(force_ui=True)
+
+        self.push_screen(RenameTaskModal(task.name, task.display_name), handle_rename)
+
     def _finish_task(self, task: Task, force: bool = False) -> None:
         """Kick off task deletion in a background thread."""
         if not self._begin_mutation("task-list"):

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/cli.py

@@ -155,6 +155,7 @@ def cmd_list(manager: TaskManager, config: Config, args: argparse.Namespace) ->
         payload = [
             {
                 "name": task.name,
+                "display_name": task.display_name,
                 "path": str(task.path),
                 "repos": [wt.name for wt in task.worktrees],
                 "dirty": dirty[task.name],

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/commands.py

@@ -12,6 +12,11 @@ APP_COMMANDS: list[tuple[str, str, str]] = [
     ("clone_task", "Clone Task", "Create a new task with the same repos as the current one"),
     ("add_repo", "Add Repo", "Add repositories to the current task"),
     ("delete_task", "Delete Task", "Delete the current task (with safety checks)"),
+    (
+        "rename_task",
+        "Rename Task",
+        "Set a display alias for the current task (folder/branch unchanged)",
+    ),
     ("delete_worktree", "Delete Worktree", "Delete the selected worktree from the task"),
     ("open_lazygit", "Open Lazygit", "Open lazygit in the selected worktree"),
     (

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/services/config.py

@@ -23,6 +23,7 @@ DEFAULT_KEYBINDINGS: dict[str, str] = {
     "clone_task": "y",
     "add_repo": "a",
     "delete_task": "d",
+    "rename_task": "R",
     "open_lazygit": "g",
     "show_diff": "h",
     "open_folder": "o",
@@ -424,6 +425,7 @@ new_task = "{self._toml_escape(self.keybindings.get("new_task", "n"))}"
 clone_task = "{self._toml_escape(self.keybindings.get("clone_task", "y"))}"
 add_repo = "{self._toml_escape(self.keybindings.get("add_repo", "a"))}"
 delete_task = "{self._toml_escape(self.keybindings.get("delete_task", "d"))}"
+rename_task = "{self._toml_escape(self.keybindings.get("rename_task", "R"))}"
 open_lazygit = "{self._toml_escape(self.keybindings.get("open_lazygit", "g"))}"
 show_diff = "{self._toml_escape(self.keybindings.get("show_diff", "h"))}"
 open_folder = "{self._toml_escape(self.keybindings.get("open_folder", "o"))}"

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/services/models.py

@@ -48,6 +48,24 @@ class Task:
         """Check if the task has a CLAUDE.md file."""
         return (self.path / "CLAUDE.md").exists()
 
+    @property
+    def display_name(self) -> str | None:
+        """Display alias from <task>/.tasktree_name, or None when unset.
+
+        Read lazily from disk so every Task construction site picks it up
+        and a rename is visible on the next render without reloading.
+        """
+        try:
+            value = (self.path / ".tasktree_name").read_text(encoding="utf-8").strip()
+        except OSError:
+            return None
+        return value or None
+
+    @property
+    def display_label(self) -> str:
+        """What the task list shows: the alias when set, else the real name."""
+        return self.display_name or self.name
+
 
 @dataclass
 class GitStatus:

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/services/task_manager.py

@@ -337,6 +337,22 @@ class TaskManager:
         if task.path.exists():
             shutil.rmtree(task.path)
 
+    def set_task_display_name(self, task: Task, display_name: str | None) -> None:
+        """Set or clear the task's display alias (TUI label only).
+
+        The folder, branches and worktrees keep the real task name; the alias
+        lives in <task>/.tasktree_name. Empty input — or an alias equal to the
+        real name — clears the file.
+        """
+        marker = task.path / ".tasktree_name"
+        name = (display_name or "").strip()
+        if name == task.name:
+            name = ""
+        if name:
+            marker.write_text(name + "\n", encoding="utf-8")
+        elif marker.exists():
+            marker.unlink()
+
     def archive_task(self, task: Task, notes: list[str] | None = None) -> Path | None:
         """Write the task's combined diff to the archive directory.
 

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/widgets/create_modal.py

@@ -462,6 +462,53 @@ class SafeDeleteModal(ThemedModalScreen[str | None]):
             self.dismiss("force")
 
 
+class RenameTaskModal(ThemedModalScreen[str | None]):
+    """Prompt for a task's display alias (TUI label only).
+
+    Dismisses with the new alias, "" to revert to the real name, or None
+    when cancelled.
+    """
+
+    CANCEL_RESULT: ClassVar[None] = None
+
+    def __init__(self, task_name: str, current_alias: str | None, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.task_name = task_name
+        self.current_alias = current_alias
+
+    def compose(self) -> ComposeResult:
+        with Container():
+            yield Label("Rename Task (display only)", classes="modal-title")
+            yield Static(
+                escape(f"Folder/branch stay '{self.task_name}'; empty input reverts."),
+                classes="modal-message",
+            )
+            yield Input(
+                value=self.current_alias or "",
+                placeholder=self.task_name,
+                id="rename-input",
+            )
+            with Horizontal(classes="button-row"):
+                yield Button("Rename", variant="primary", id="rename-btn")
+                yield Button("Cancel", variant="default", id="cancel-btn")
+
+    def on_mount(self) -> None:
+        super().on_mount()
+        self.query_one("#rename-input", Input).focus()
+
+    def _submit(self) -> None:
+        self.dismiss(self.query_one("#rename-input", Input).value.strip())
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        self._submit()
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "rename-btn":
+            self._submit()
+        elif event.button.id == "cancel-btn":
+            self.dismiss(None)
+
+
 class DispatchAgentModal(ThemedModalScreen[str | None]):
     """Prompt for dispatching a background Claude agent into a worktree.
 
@@ -669,7 +716,12 @@ class HelpModal(ThemedModalScreen[None]):
         task_section += (
             self._format_binding("add_repo", "a", "Add repository to current task") + "\n"
         )
-        task_section += self._format_binding("delete_task", "d", "Delete/finish current task")
+        task_section += (
+            self._format_binding("delete_task", "d", "Delete/finish current task") + "\n"
+        )
+        task_section += self._format_binding(
+            "rename_task", "R", "Rename task display label (folder/branch unchanged)"
+        )
         sections.append(task_section)
 
         # Tools section

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tasktree_manager/widgets/task_list.py

@@ -88,10 +88,10 @@ class TaskList(OptionList):
             hook_indicator = " [green]✓[/]"
         else:
             hook_indicator = ""
-        # Escape the name: task directories can be created outside tasktree,
-        # and markup-significant brackets in a name must not style (or crash)
+        # Escape the label: task directories (and aliases) can hold
+        # markup-significant brackets which must not style (or crash)
         # the list rendering
-        name = escape(task.name)
+        name = escape(task.display_label)
         if task.is_dirty:
             prompt = f"[red]●[/]{claude_md}{name} [red]({task.dirty_count})[/]{hook_indicator}"
         else:
@@ -220,9 +220,9 @@ class TaskList(OptionList):
         """Sort tasks according to current sort mode."""
         match self._sort_mode:
             case SortMode.NAME_ASC:
-                return sorted(tasks, key=lambda t: t.name.lower())
+                return sorted(tasks, key=lambda t: t.display_label.lower())
             case SortMode.NAME_DESC:
-                return sorted(tasks, key=lambda t: t.name.lower(), reverse=True)
+                return sorted(tasks, key=lambda t: t.display_label.lower(), reverse=True)
             case SortMode.DATE_NEWEST:
                 return sorted(
                     tasks,

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tests/test_app.py

@@ -392,6 +392,72 @@ class TestOpenExternalCommands:
             assert app.is_running
 
 
+class TestRenameTaskAction:
+    """Tests for the rename (display alias) action."""
+
+    async def test_rename_via_keybinding(self, app, sample_repo, task_manager):
+        """R -> modal -> alias shows in the task list; folder unchanged."""
+        from tasktree_manager.widgets.create_modal import RenameTaskModal
+
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("RENAME-TASK", ["sample-repo"], branch)
+
+        async with app.run_test() as pilot:
+            await pilot.pause()
+            await pilot.press("R")
+            await pilot.pause()
+            assert isinstance(app.screen_stack[-1], RenameTaskModal)
+
+            await pilot.press(*"nice label")
+            await pilot.press("enter")
+            await app.workers.wait_for_complete()
+            await pilot.pause()
+
+            assert (task.path / ".tasktree_name").read_text().strip() == "nice label"
+            assert task.path.exists()  # folder untouched
+            task_list = app.query_one("#task-list", TaskList)
+            prompt = str(task_list.get_option("RENAME-TASK").prompt)
+            assert "nice label" in prompt
+            assert "RENAME-TASK" not in prompt
+
+    async def test_rename_cancel_changes_nothing(self, app, sample_repo, task_manager):
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("RENAME-CANCEL", ["sample-repo"], branch)
+
+        async with app.run_test() as pilot:
+            await pilot.pause()
+            await pilot.press("R")
+            await pilot.pause()
+            await pilot.press("escape")
+            await pilot.pause()
+            assert not (task.path / ".tasktree_name").exists()
+
+    async def test_rename_empty_reverts(self, app, sample_repo, task_manager):
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("RENAME-REVERT", ["sample-repo"], branch)
+        task_manager.set_task_display_name(task, "old label")
+
+        async with app.run_test() as pilot:
+            await pilot.pause()
+            await pilot.press("R")
+            await pilot.pause()
+            # Prefilled with the current alias - clear it
+            from textual.widgets import Input
+
+            from tasktree_manager.widgets.create_modal import RenameTaskModal
+
+            modal = app.screen_stack[-1]
+            assert isinstance(modal, RenameTaskModal)
+            modal.query_one("#rename-input", Input).value = ""
+            await pilot.press("enter")
+            await app.workers.wait_for_complete()
+            await pilot.pause()
+
+            assert not (task.path / ".tasktree_name").exists()
+            task_list = app.query_one("#task-list", TaskList)
+            assert "RENAME-REVERT" in str(task_list.get_option("RENAME-REVERT").prompt)
+
+
 class TestShowDiffAction:
     """Tests for the hunk diff action (h)."""
 

{tasktree_manager-2.11.1 → tasktree_manager-2.12.0}/tests/test_task_manager.py

@@ -433,6 +433,48 @@ class TestTaskBaseRecording:
         assert GitOps.get_task_base(worktree_from_repo, "no-such-branch") is None
 
 
+class TestDisplayName:
+    """Display alias: TUI label only, folder/branch untouched."""
+
+    def test_set_and_read_alias(self, task_manager, sample_repo):
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("DIC-1901-argocd-tls", ["sample-repo"], branch)
+
+        task_manager.set_task_display_name(task, "ArgoCD TLS rollout")
+        assert task.display_name == "ArgoCD TLS rollout"
+        assert task.display_label == "ArgoCD TLS rollout"
+        # Real identity untouched
+        assert task.name == "DIC-1901-argocd-tls"
+        assert task.path.name == "DIC-1901-argocd-tls"
+        assert (task.path / ".tasktree_name").exists()
+        # A fresh load sees the alias too (read lazily from disk)
+        reloaded = task_manager.get_task("DIC-1901-argocd-tls")
+        assert reloaded is not None
+        assert reloaded.display_label == "ArgoCD TLS rollout"
+
+    def test_clear_alias_with_empty(self, task_manager, sample_repo):
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("ALIAS-CLEAR", ["sample-repo"], branch)
+        task_manager.set_task_display_name(task, "temp label")
+        task_manager.set_task_display_name(task, "")
+        assert task.display_name is None
+        assert task.display_label == "ALIAS-CLEAR"
+        assert not (task.path / ".tasktree_name").exists()
+
+    def test_alias_equal_to_real_name_clears(self, task_manager, sample_repo):
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("ALIAS-SAME", ["sample-repo"], branch)
+        task_manager.set_task_display_name(task, "ALIAS-SAME")
+        assert not (task.path / ".tasktree_name").exists()
+        assert task.display_label == "ALIAS-SAME"
+
+    def test_no_alias_by_default(self, task_manager, sample_repo):
+        repo_path, branch = sample_repo
+        task = task_manager.create_task("ALIAS-NONE", ["sample-repo"], branch)
+        assert task.display_name is None
+        assert task.display_label == "ALIAS-NONE"
+
+
 class TestForgeAwareSafety:
     """Squash/rebase merges detected via the forge (glab/gh) MR state."""