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

{tasktree_manager-2.11.0 → tasktree_manager-2.12.0}/CHANGELOG.md

@@ -15,6 +15,18 @@ 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
+- **tui**: Open editor in new terminal tab, drop Enter shell binding
+
+
 ## [2.11.0] - 2026-07-30
 
 ### Added

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

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

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

@@ -63,7 +63,7 @@ On first run, you'll configure:
 ### Basic Workflow
 
 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
+2. **Work on code** - Press `e` for editor, `g` for lazygit, or `o` for a shell in a new terminal tab
 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
@@ -107,12 +107,13 @@ a Claude Code statusline or shell prompt.
 | `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 |
+| `P` | Pull all | `y` | Clone task |
 | `c` | Claude (resume) | `C` | Claude (new) |
 | `b` | Dispatch agent | `D` | Delete worktree |
 | `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.0 → tasktree_manager-2.12.0}/docs/configuration.md

@@ -180,11 +180,6 @@ claude_memory_dir = "~/.claude/tasktree-memory"
 # Default: true
 claude_repo_memory = true
 
-# Preferred shell
-# Leave empty to use $SHELL environment variable
-# Default: "" (uses $SHELL, falls back to /bin/bash)
-shell = ""
-
 # Path to glab executable (GitLab CLI, used for MR/CI status)
 # Default: "glab" (searches PATH)
 glab_path = "glab"
@@ -228,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
@@ -235,7 +231,6 @@ 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
 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
@@ -399,7 +394,6 @@ 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  |
 | `glab_path`   | string | `"glab"`    | -                   | Path to GitLab CLI (MR/CI status)    |
 | `gh_path`     | string | `"gh"`      | -                   | Path to GitHub CLI (PR/CI status)    |
 
@@ -438,12 +432,6 @@ failures degrade silently — features fall back to plain git behavior.
 - 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`
-- Examples: `"/bin/zsh"`, `"/bin/fish"`, `"/usr/local/bin/bash"`
-- Used when pressing `Enter` to open shell in worktree
-
 ## Symlinks
 
 When creating worktrees, tasktree-manager automatically symlinks gitignored files (like `.env`) from the source repository. This allows environment files to be shared without copying.
@@ -596,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
 
@@ -605,7 +594,6 @@ All 22 customizable keybindings with descriptions:
 | `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"`     |
 | `push_all`     | `p`      | Push all worktrees in current task    | `push_all = "ctrl+p"`       |
 | `pull_all`     | `P`      | Pull all worktrees in current task    | `pull_all = "ctrl+shift+p"` |
 | `refresh`      | `r`      | Refresh git status for all worktrees  | `refresh = "F5"`            |
@@ -675,7 +663,7 @@ focus_previous = "h"
 [keybindings]
 new_task = "ctrl+n"
 delete_task = "ctrl+d"
-open_shell = "ctrl+t"
+open_folder = "ctrl+t"
 refresh = "F5"
 quit = "ctrl+q"
 ```

{tasktree_manager-2.11.0 → tasktree_manager-2.12.0}/docs/troubleshooting.md

@@ -732,8 +732,8 @@ HEAD detached at abc1234
 
 **Solution:**
 ```bash
-# Open shell in worktree
-Press Enter
+# Open worktree in a new terminal tab
+Press o
 
 # Create/checkout branch
 git checkout -b FEAT-123
@@ -1008,7 +1008,7 @@ Create
 
 # Your work is in the remote branch
 # Pull it down in the new worktree
-Press Enter (shell)
+Press o (new terminal tab)
 git pull origin FEAT-123
 ```
 

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

@@ -140,10 +140,10 @@ A **worktree** is a git working directory for a specific repository within a tas
    - Exit hunk (press `q`)
 
 4. **Or open a shell:**
-   - Press `Enter` to open a shell in the worktree
+   - Press `o` to open the worktree in a new terminal tab
    - Make changes with your editor/IDE
    - Run build/test commands
-   - Exit shell (type `exit`)
+   - Close the tab (or switch back) when done
 
 5. **Push changes:**
    - Press `p` to push all worktrees in the task
@@ -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`
@@ -337,8 +338,7 @@ Useful when you're spinning up several similar tasks that share the same set of
 |---------|--------------------|------------------------------------------------------|
 | `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                |
+| `e`     | Open editor        | Open editor in a new terminal tab at the task/worktree folder (runs `$EDITOR .`; the TUI keeps running) |
 | `p`     | Push all           | Push all worktrees in the current task (parallel)    |
 | `P`     | Pull all           | Pull all worktrees in the current task (parallel)    |
 | `r`     | Refresh status     | Refresh git status for all tasks and worktrees       |
@@ -434,9 +434,9 @@ Create
 # Work in backend
 Tab (to worktree list)
 j (to highlight backend)
-Enter (open shell)
+o (open new terminal tab)
 
-# In shell: make changes
+# In the tab: make changes
 cd src
 vim auth.py
 # ... make changes ...
@@ -516,7 +516,7 @@ Select: backend
 Create
 
 Tab
-Enter (open shell)
+o (open new terminal tab)
 git fetch origin feat-789:feat-789
 git checkout feat-789
 exit
@@ -553,7 +553,7 @@ q (quit tasktree-manager)
 tasktree-manager
 j (select FEAT-999)
 Tab
-Enter (shell in first worktree)
+o (new tab in first worktree)
 
 # Merge main into feature branch
 git fetch origin main:main
@@ -631,7 +631,7 @@ d (delete task)
 **Working in worktree:**
 - Press `e` to open editor directly in worktree
 - Press `g` for lazygit (recommended for git operations)
-- Press `Enter` for shell (for building, testing, or other commands)
+- Press `o` for a shell in a new terminal tab (building, testing, other commands)
 
 **Git operations:**
 - **Staging/committing**: Use lazygit (`g`)
@@ -764,9 +764,9 @@ editor = "nvim"  # or "vim", "code", "emacs", etc.
 
 Or set the `$EDITOR` environment variable.
 
-**Alternative: Open shell first:**
-1. Press `Enter` (open shell)
-2. In shell:
+**Alternative: Open a terminal tab first:**
+1. Press `o` (new terminal tab in the worktree)
+2. In the tab:
    ```bash
    vim .               # Vim
    nvim .              # Neovim
@@ -807,7 +807,7 @@ tasktree-manager creates normal git branches, so CI/CD works seamlessly:
 Integrate with GitHub CLI for PR creation:
 
 ```bash
-# In worktree shell (press Enter in tasktree-manager)
+# In a worktree tab (press o in tasktree-manager)
 gh pr create --title "Add authentication" --body "Implements FEAT-123"
 
 # Or after pushing all worktrees

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

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

{tasktree_manager-2.11.0 → 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
@@ -208,7 +209,6 @@ class TaskTreeApp(App):
         Binding("m", "toggle_messages", "Messages", show=False),
         Binding("?", "help", "Help"),
         Binding("q", "quit", "Quit"),
-        Binding("enter", "open_shell", "Shell", show=False),
         Binding("C", "open_claude_gui_code", "Claude GUI", show=False),
         Binding("P", "pull_all", "Pull All", show=False),
         Binding("S", "toggle_grouping", "Group", show=False),
@@ -275,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),
@@ -287,7 +288,6 @@ class TaskTreeApp(App):
             Binding(kb.get("toggle_messages", "m"), "toggle_messages", "Messages", show=False),
             Binding(kb.get("help", "?"), "help", "Help"),
             Binding(kb.get("quit", "q"), "quit", "Quit"),
-            Binding(kb.get("open_shell", "enter"), "open_shell", "Shell", show=False),
             Binding(
                 kb.get("open_claude_gui_code", "C"),
                 "open_claude_gui_code",
@@ -322,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"),
@@ -331,7 +332,6 @@ class TaskTreeApp(App):
             (kb.get("show_diff", "h"), "show_diff", "Diff"),
             (kb.get("open_editor", "e"), "open_editor", "Editor"),
             (kb.get("open_folder", "o"), "open_folder", "Open"),
-            (kb.get("open_shell", "enter"), "open_shell", "Shell"),
             (kb.get("dispatch_agent", "b"), "dispatch_agent", "Agent"),
             (kb.get("push_all", "p"), "push_all", "Push"),
             (kb.get("delete_worktree", "D"), "delete_worktree", "Del WT"),
@@ -1193,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"):
@@ -1515,37 +1537,13 @@ class TaskTreeApp(App):
         # Restore focus to task list
         self.query_one("#task-list", TaskList).focus()
 
-    def action_open_shell(self) -> None:
-        """Open a shell in the current worktree."""
-        if not self.current_worktree:
-            self.notify("No worktree selected", severity="warning")
-            return
-
-        worktree_path = self.current_worktree.path
-        if not worktree_path.exists():
-            self.notify("Worktree directory not found", severity="error")
-            return
-
-        # Save selection state BEFORE suspend (as local variables)
-        saved_task_name = self.current_task.name if self.current_task else None
-        saved_worktree_name = self.current_worktree.name
-
-        # Get shell from config
-        shell = self.config.get_shell()
-
-        self.notify("Opening shell...")
-
-        # Suspend app and open shell
-        with self.suspend():
-            self._run_external_command([shell], cwd=worktree_path, name="shell")
-
-        # Refresh status after shell exits, restoring saved selection
-        self._load_tasks_with_selection(saved_task_name, saved_worktree_name)
-        # Restore focus to worktree list
-        self.query_one("#worktree-list", WorktreeList).focus()
-
     def action_open_editor(self) -> None:
-        """Open editor in the current folder (task or worktree based on focus)."""
+        """Open editor in a new terminal tab at the current folder.
+
+        Same mechanism as open_folder: the TUI keeps running instead of
+        suspending, so the editor session and the dashboard live side by
+        side (matches the `o`/`c` new-tab behavior).
+        """
         focused = self.focused
 
         # Determine folder based on focus (like open_folder does)
@@ -1562,24 +1560,9 @@ class TaskTreeApp(App):
             self.notify("Folder not found", severity="error")
             return
 
-        # Save selection state BEFORE suspend
-        saved_task_name = self.current_task.name if self.current_task else None
-        saved_worktree_name = self.current_worktree.name if self.current_worktree else None
-
         editor = self.config.get_editor()
-        self.notify(escape(f"Opening {editor}..."))
-
-        # Suspend app and run editor with "." to open directory
-        with self.suspend():
-            self._run_external_command([editor, "."], cwd=folder_path, name="editor")
-
-        # Refresh status after editor exits, restoring saved selection
-        self._load_tasks_with_selection(saved_task_name, saved_worktree_name)
-        # Restore focus to the panel that was focused
-        if isinstance(focused, TaskList):
-            self.query_one("#task-list", TaskList).focus()
-        else:
-            self.query_one("#worktree-list", WorktreeList).focus()
+        self._open_ghostty_tab(folder_path, command=f"{editor} .")
+        self.notify(escape(f"Opened {editor} in new tab"))
 
     def _prepare_claude_session(self, task_path: Path) -> None:
         """Refresh CLAUDE.md files, worktree settings, and hooks before launching Claude."""

{tasktree_manager-2.11.0 → 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.0 → 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"),
     (
@@ -19,9 +24,12 @@ APP_COMMANDS: list[tuple[str, str, str]] = [
         "Show Diff",
         "Open hunk: all repos from the task panel, the selected repo from the worktree panel",
     ),
-    ("open_editor", "Open Editor", "Open your editor in the focused task/worktree folder"),
+    (
+        "open_editor",
+        "Open Editor",
+        "Open your editor in a new terminal tab at the focused task/worktree folder",
+    ),
     ("open_folder", "Open Folder", "Open the focused folder in a new terminal tab"),
-    ("open_shell", "Open Shell", "Open a shell in the selected worktree"),
     ("open_claude_resume", "Open Claude", "Open Claude Code for the task (resume if possible)"),
     (
         "dispatch_agent",

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

@@ -23,10 +23,10 @@ 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",
-    "open_shell": "enter",
     "open_editor": "e",
     "open_claude_resume": "c",
     "open_claude_gui_code": "C",
@@ -122,7 +122,6 @@ class Config:
     claude_path: str = "claude"
     claude_memory_dir: str = "~/.claude/tasktree-memory"
     claude_repo_memory: bool = True
-    shell: str = ""
     glab_path: str = "glab"
     gh_path: str = "gh"
 
@@ -184,7 +183,6 @@ class Config:
         claude_path = tools_config.get("claude_path", "claude")
         claude_memory_dir = tools_config.get("claude_memory_dir", "~/.claude/tasktree-memory")
         claude_repo_memory = bool(tools_config.get("claude_repo_memory", True))
-        shell = tools_config.get("shell", "")
         glab_path = tools_config.get("glab_path", "glab")
         gh_path = tools_config.get("gh_path", "gh")
 
@@ -221,8 +219,6 @@ class Config:
             default_base_branch = os.environ["TASKTREE_DEFAULT_BRANCH"]
         if "EDITOR" in os.environ and not editor:
             editor = os.environ["EDITOR"]
-        if "SHELL" in os.environ and not shell:
-            shell = os.environ["SHELL"]
 
         return cls(
             repos_dir=repos_dir,
@@ -243,7 +239,6 @@ class Config:
             claude_path=claude_path,
             claude_memory_dir=claude_memory_dir,
             claude_repo_memory=claude_repo_memory,
-            shell=shell,
             glab_path=glab_path,
             gh_path=gh_path,
             forge_enabled=forge_enabled,
@@ -398,9 +393,6 @@ claude_memory_dir = "{self._toml_escape(self.claude_memory_dir)}"
 # same repo and with the main checkout. Set to false to disable.
 claude_repo_memory = {str(self.claude_repo_memory).lower()}
 
-# Preferred shell (leave empty to use $SHELL)
-shell = "{self._toml_escape(self.shell)}"
-
 # Path to glab executable (GitLab CLI, used for MR/CI status)
 glab_path = "{self._toml_escape(self.glab_path)}"
 
@@ -433,10 +425,10 @@ 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"))}"
-open_shell = "{self._toml_escape(self.keybindings.get("open_shell", "enter"))}"
 open_editor = "{self._toml_escape(self.keybindings.get("open_editor", "e"))}"
 open_claude_resume = "{self._toml_escape(self.keybindings.get("open_claude_resume", "c"))}"
 open_claude_gui_code = "{self._toml_escape(self.keybindings.get("open_claude_gui_code", "C"))}"
@@ -513,12 +505,6 @@ blocklist = {self._toml_list(self.symlink_blocklist)}
 
         return sorted(repos)
 
-    def get_shell(self) -> str:
-        """Get the shell to use, with fallback to environment or /bin/bash."""
-        if self.shell:
-            return self.shell
-        return os.environ.get("SHELL", "/bin/bash")
-
     def get_editor(self) -> str:
         """Get the editor to use, with fallback to environment or vi."""
         if self.editor:

{tasktree_manager-2.11.0 → 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.0 → 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.0 → 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
@@ -684,9 +736,8 @@ class HelpModal(ThemedModalScreen[None]):
             + "\n"
         )
         tools_section += (
-            self._format_binding("open_shell", "enter", "Open shell in worktree") + "\n"
+            self._format_binding("open_editor", "e", "Open editor in new terminal tab") + "\n"
         )
-        tools_section += self._format_binding("open_editor", "e", "Open editor in folder") + "\n"
         tools_section += (
             self._format_binding(
                 "open_claude_resume", "c", "Open Claude CLI (resume if session exists, else new)"

{tasktree_manager-2.11.0 → 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.0 → tasktree_manager-2.12.0}/tasktree_manager/widgets/worktree_list.py

@@ -76,9 +76,8 @@ class WorktreeList(OptionList):
         self._max_branch_len: int = 0
         # Footer-visible (key, app action, description) bindings shown while
         # this panel has focus; the keys also exist app-level (hidden) so
-        # they keep working regardless of focus. Replacing "enter" here also
-        # fixes shell opening: OptionList's own select binding used to
-        # swallow the key before the app's open_shell binding could see it.
+        # they keep working regardless of focus. Keys are popped first so a
+        # context binding can override an OptionList default for that key.
         for key, action, description in context_bindings or []:
             self._bindings.key_to_bindings.pop(key, None)
             self._bindings.bind(key, f"app.{action}", description, show=True)

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

@@ -391,20 +391,71 @@ class TestOpenExternalCommands:
             # App should still be running
             assert app.is_running
 
-    async def test_open_shell_no_worktree_warning(self, app, sample_repo, task_manager):
-        """Test that shell with no worktree selected shows warning."""
+
+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)
 
-            # Clear current worktree
-            app.current_worktree = None
+            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")
 
-            # Press enter for shell
+        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()
 
-            # App should still be running
-            assert app.is_running
+            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:
@@ -651,7 +702,6 @@ class TestContextSensitiveFooter:
             assert "app.delete_task" in shown
             # Worktree-context actions are hidden in this context
             assert "app.open_lazygit" not in shown
-            assert "app.open_shell" not in shown
             # Globals always visible
             assert "cycle_theme" in shown
             assert "refresh" in shown
@@ -675,7 +725,6 @@ class TestContextSensitiveFooter:
             assert app.focused.id == "worktree-list"
             shown = self._shown_actions(app)
             assert "app.open_lazygit" in shown
-            assert "app.open_shell" in shown
             assert "app.push_all" in shown
             # Task-context actions are hidden in this context
             assert "app.new_task" not in shown
@@ -699,22 +748,3 @@ class TestContextSensitiveFooter:
 
             create_modals = [s for s in app.screen_stack if isinstance(s, CreateTaskModal)]
             assert len(create_modals) == 1
-
-    async def test_enter_opens_shell_from_worktree_list(
-        self, app, sample_repo, task_manager, monkeypatch
-    ):
-        """Enter on the worktree list triggers open_shell (was swallowed by select)."""
-        repo_path, branch = sample_repo
-        task_manager.create_task("FOOTER-ENTER", ["sample-repo"], branch)
-
-        called = []
-        monkeypatch.setattr(app, "action_open_shell", lambda: called.append(True))
-
-        async with app.run_test() as pilot:
-            await pilot.pause()
-            await pilot.press("tab")
-            await pilot.pause()
-            await pilot.press("enter")
-            await pilot.pause()
-
-        assert called

{tasktree_manager-2.11.0 → tasktree_manager-2.12.0}/tests/test_config.py

@@ -131,7 +131,6 @@ class TestConfig:
         assert config.editor == ""
         assert config.lazygit_path == "lazygit"
         assert config.hunk_path == "hunk"
-        assert config.shell == ""
         assert config.archive_dir == ""
         assert config.agent_poll_interval == 10
         assert config.forge_poll_interval == 60
@@ -233,7 +232,6 @@ timeout = 60
 editor = "nvim"
 lazygit_path = "/usr/local/bin/lazygit"
 hunk_path = "/usr/local/bin/hunk"
-shell = "/bin/zsh"
 '''
         config_file.write_text(config_content)
 
@@ -254,24 +252,12 @@ shell = "/bin/zsh"
             assert config.editor == "nvim"
             assert config.lazygit_path == "/usr/local/bin/lazygit"
             assert config.hunk_path == "/usr/local/bin/hunk"
-            assert config.shell == "/bin/zsh"
         finally:
             if old_xdg is not None:
                 os.environ["XDG_CONFIG_HOME"] = old_xdg
             else:
                 os.environ.pop("XDG_CONFIG_HOME", None)
 
-    def test_get_shell_from_config(self):
-        """Test get_shell returns config value when set."""
-        config = Config(shell="/bin/zsh")
-        assert config.get_shell() == "/bin/zsh"
-
-    def test_get_shell_fallback_to_env(self, monkeypatch):
-        """Test get_shell falls back to environment."""
-        monkeypatch.setenv("SHELL", "/bin/fish")
-        config = Config(shell="")
-        assert config.get_shell() == "/bin/fish"
-
     def test_get_editor_from_config(self):
         """Test get_editor returns config value when set."""
         config = Config(editor="nvim")
@@ -304,7 +290,6 @@ shell = "/bin/zsh"
             editor="vim",
             lazygit_path="/opt/bin/lazygit",
             hunk_path="/opt/bin/hunk",
-            shell="/bin/zsh",
             glab_path="/opt/bin/glab",
             gh_path="/opt/bin/gh",
             forge_enabled=False,
@@ -329,7 +314,6 @@ shell = "/bin/zsh"
             assert loaded.editor == "vim"
             assert loaded.lazygit_path == "/opt/bin/lazygit"
             assert loaded.hunk_path == "/opt/bin/hunk"
-            assert loaded.shell == "/bin/zsh"
             assert loaded.archive_dir == "/tmp/archive"
             assert loaded.agent_poll_interval == 15
             assert loaded.forge_poll_interval == 90

{tasktree_manager-2.11.0 → 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."""