gitdirector 1.4.5__tar.gz → 1.5.2__tar.gz

{gitdirector-1.4.5 → gitdirector-1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gitdirector
-Version: 1.4.5
+Version: 1.5.2
 Summary: A terminal based control plane for developers working across multiple repositories. Launch multiple AI coding agents, multiple tmux sessions and track changes across all your repos in one place.
 Keywords: git,repository,manager,cli,synchronization,batch
 Author: Anito Anto
@@ -74,8 +74,9 @@ If you find GitDirector useful, please star this repository on GitHub, we need m
 | `gitdirector status`                         | Show repositories with staged/unstaged files           |
 | `gitdirector pull`                           | Pull latest changes for all tracked repositories       |
 | `gitdirector cd NAME`                        | Open or switch to a tmux session for a repository      |
-| `gitdirector autoclean links\|sessions`      | Clean broken links or stale tmux sessions              |
+| `gitdirector autoclean`                      | Remove broken repository links from tracking           |
 | `gitdirector info PATH\|NAME [--full]`       | Show file statistics for a repository                  |
+| `gitdirector gd-tmux PATH\|NAME "command"`   | Create a gd tmux session and run a command in it       |
 | `gitdirector help`                           | Show help                                              |
 
 ### link
@@ -103,8 +104,9 @@ Features:
 - `r` to refresh all statuses
 - Press `enter` on any repository to open an action menu:
     - **New tmux session** — create and attach a session for the repository
+    - **Review Diff** — open a two-pane viewer for uncommitted changes (left: file list with GitHub-style status pills and +/- counts; right: per-file unified diff with GitHub-dark syntax highlighting, line numbers, and green/red backgrounds for added/removed lines). Navigate files with `j`/`k`, `n`/`p`, `g`/`G`, or `]`/`[`. Switch the focused panel with `tab`. `r` refreshes, `esc` closes.
     - **Attach existing session** — switch to any already-running tmux session
-    - **Launch AI agent** — open OpenCode, Claude Code, GitHub Copilot, or Codex in a new tmux session
+    - **Launch AI agent** — open OpenCode, Claude Code, GitHub Copilot, Codex, or Pi in a new tmux session
     - **Remove session** — kill a running tmux session
 
 ### unlink
@@ -174,6 +176,68 @@ Opens a [tmux](https://github.com/tmux/tmux) session rooted at the repository di
 > Debian/Ubuntu: `sudo apt install tmux`  
 > Arch: `sudo pacman -S tmux`
 
+### gd-tmux
+
+```bash
+gitdirector gd-tmux my-repo "npm test"
+gitdirector gd-tmux /path/to/my-repo "make build"
+gitdirector gd-tmux my-repo 'echo "hello world"'
+```
+
+Creates a new gd tmux session rooted at the given repository, runs the supplied command inside it, and attaches the session. The session is created using the same code path the TUI's **Launch AI agent** menu uses: it is a real `gd/{repo}/{command}/{N}` session, visible in the Sessions tab of `gitdirector console`, and it self-destructs when the command exits.
+
+- `PATH|NAME` — accept either an absolute path to a tracked repository or its basename, with the same disambiguation rules as `gitdirector unlink`.
+- `"command"` — the shell command to run inside the new session. Pass it quoted so the shell hands the whole string to gitdirector; quotes and arguments are preserved verbatim.
+
+The command is the same as opening the repo in the console, picking **Launch AI agent** from the action menu, and entering the command — but you can do it from any shell without entering the TUI first. The new session shows up in the Sessions tab immediately.
+
+### autoclean
+
+```bash
+gitdirector autoclean
+```
+
+Scans the tracked repositories in `~/.gitdirector/config.yaml` for paths that no longer exist on disk and removes them from the config. Lists any broken links for review and asks for confirmation before deleting them.
+
+## Note for AI coding agents
+
+If you are an AI coding agent reading this project: when the user asks you to run a long-lived process inside a tracked repository — a dev server, a frontend bundler, a backend API, a watcher, a database, a test runner with a long timeout, or anything else that does not exit on its own — **do not run it in the foreground**. A foreground process will block your shell for the rest of the session and the user will not be able to interact with you.
+
+Use `gitdirector gd-tmux` to launch the process in a detached gd tmux session that the user can monitor and tear down themselves. The session shows up in the Sessions tab of `gitdirector console`, auto-cleans up when the process exits, and supports path-or-name lookup the same way every other gitdirector command does.
+
+**Always prefer the absolute path over the repo name.** The by-name lookup matches the *directory name on disk* verbatim (via `Path.name`) — case-sensitive, dots and spaces included — and is ambiguous if two tracked repos share the same basename. When in doubt, look up the path with `gitdirector list` and use the absolute path. Quoting a path is fine; an absolute path is never ambiguous.
+
+Examples:
+
+```bash
+# Frontend dev server in the user's web repo — use the absolute path
+gitdirector gd-tmux /Users/me/projects/webapp "npm run dev"
+
+# Backend API in the api repo
+gitdirector gd-tmux /Users/me/projects/api "uvicorn app.main:app --reload --port 8000"
+
+# A long-running integration test with output captured to a log
+gitdirector gd-tmux /Users/me/projects/myrepo "pytest -x -v 2>&1 | tee /tmp/test.log"
+
+# A watcher or build loop
+gitdirector gd-tmux /Users/me/projects/myrepo "npm run watch"
+
+# A repo whose directory name contains a space — quote both the path and the command
+gitdirector gd-tmux "/Users/me/projects/My Repo" "npm run dev"
+```
+
+The by-name form is supported for ergonomic use by humans in interactive shells, but agents should default to the absolute path to avoid any chance of matching the wrong repo.
+
+Rules of thumb:
+
+- **Use the absolute path.** It is unambiguous and survives the user renaming or moving the directory. The by-name form is convenient shorthand, not a slug — it is the raw directory name, case-sensitive.
+- **Repo names with spaces, dots, or punctuation are matched verbatim** when you do use the by-name form. A repo at `/Users/me/My Repo` is matched by `"My Repo"`, not by `My` or `Repo`. Quote the name to keep the shell from splitting it.
+- **Quoting the command matters.** The command string is handed to `sh -lc` inside the new session, so write it as a single quoted string. `'echo "hi"'` (single-quote outer, double-quote inner) is the safest pattern for embedded double quotes.
+- **Path separators in the command are fine.** Commands like `python /path/to/script.py` or `find . -name foo/bar` work; the command is embedded verbatim into the inner shell, while the session-name label is auto-sanitized.
+- **The session self-destructs** when the command exits (success or failure), so you do not need to clean it up.
+- **If you need to capture output**, redirect it to a file in the command itself (`> /tmp/out 2>&1`) and read the file later — the session is gone once the command exits.
+- **If the user asks you to stop a running process**, kill the matching session: `gitdirector console` → Sessions tab, or directly with `tmux kill-session -t =<session-name>`.
+
 ## Configuration
 
 Config is stored at `~/.gitdirector/config.yaml`.

{gitdirector-1.4.5 → gitdirector-1.5.2}/README.md

@@ -31,8 +31,9 @@ If you find GitDirector useful, please star this repository on GitHub, we need m
 | `gitdirector status`                         | Show repositories with staged/unstaged files           |
 | `gitdirector pull`                           | Pull latest changes for all tracked repositories       |
 | `gitdirector cd NAME`                        | Open or switch to a tmux session for a repository      |
-| `gitdirector autoclean links\|sessions`      | Clean broken links or stale tmux sessions              |
+| `gitdirector autoclean`                      | Remove broken repository links from tracking           |
 | `gitdirector info PATH\|NAME [--full]`       | Show file statistics for a repository                  |
+| `gitdirector gd-tmux PATH\|NAME "command"`   | Create a gd tmux session and run a command in it       |
 | `gitdirector help`                           | Show help                                              |
 
 ### link
@@ -60,8 +61,9 @@ Features:
 - `r` to refresh all statuses
 - Press `enter` on any repository to open an action menu:
     - **New tmux session** — create and attach a session for the repository
+    - **Review Diff** — open a two-pane viewer for uncommitted changes (left: file list with GitHub-style status pills and +/- counts; right: per-file unified diff with GitHub-dark syntax highlighting, line numbers, and green/red backgrounds for added/removed lines). Navigate files with `j`/`k`, `n`/`p`, `g`/`G`, or `]`/`[`. Switch the focused panel with `tab`. `r` refreshes, `esc` closes.
     - **Attach existing session** — switch to any already-running tmux session
-    - **Launch AI agent** — open OpenCode, Claude Code, GitHub Copilot, or Codex in a new tmux session
+    - **Launch AI agent** — open OpenCode, Claude Code, GitHub Copilot, Codex, or Pi in a new tmux session
     - **Remove session** — kill a running tmux session
 
 ### unlink
@@ -131,6 +133,68 @@ Opens a [tmux](https://github.com/tmux/tmux) session rooted at the repository di
 > Debian/Ubuntu: `sudo apt install tmux`  
 > Arch: `sudo pacman -S tmux`
 
+### gd-tmux
+
+```bash
+gitdirector gd-tmux my-repo "npm test"
+gitdirector gd-tmux /path/to/my-repo "make build"
+gitdirector gd-tmux my-repo 'echo "hello world"'
+```
+
+Creates a new gd tmux session rooted at the given repository, runs the supplied command inside it, and attaches the session. The session is created using the same code path the TUI's **Launch AI agent** menu uses: it is a real `gd/{repo}/{command}/{N}` session, visible in the Sessions tab of `gitdirector console`, and it self-destructs when the command exits.
+
+- `PATH|NAME` — accept either an absolute path to a tracked repository or its basename, with the same disambiguation rules as `gitdirector unlink`.
+- `"command"` — the shell command to run inside the new session. Pass it quoted so the shell hands the whole string to gitdirector; quotes and arguments are preserved verbatim.
+
+The command is the same as opening the repo in the console, picking **Launch AI agent** from the action menu, and entering the command — but you can do it from any shell without entering the TUI first. The new session shows up in the Sessions tab immediately.
+
+### autoclean
+
+```bash
+gitdirector autoclean
+```
+
+Scans the tracked repositories in `~/.gitdirector/config.yaml` for paths that no longer exist on disk and removes them from the config. Lists any broken links for review and asks for confirmation before deleting them.
+
+## Note for AI coding agents
+
+If you are an AI coding agent reading this project: when the user asks you to run a long-lived process inside a tracked repository — a dev server, a frontend bundler, a backend API, a watcher, a database, a test runner with a long timeout, or anything else that does not exit on its own — **do not run it in the foreground**. A foreground process will block your shell for the rest of the session and the user will not be able to interact with you.
+
+Use `gitdirector gd-tmux` to launch the process in a detached gd tmux session that the user can monitor and tear down themselves. The session shows up in the Sessions tab of `gitdirector console`, auto-cleans up when the process exits, and supports path-or-name lookup the same way every other gitdirector command does.
+
+**Always prefer the absolute path over the repo name.** The by-name lookup matches the *directory name on disk* verbatim (via `Path.name`) — case-sensitive, dots and spaces included — and is ambiguous if two tracked repos share the same basename. When in doubt, look up the path with `gitdirector list` and use the absolute path. Quoting a path is fine; an absolute path is never ambiguous.
+
+Examples:
+
+```bash
+# Frontend dev server in the user's web repo — use the absolute path
+gitdirector gd-tmux /Users/me/projects/webapp "npm run dev"
+
+# Backend API in the api repo
+gitdirector gd-tmux /Users/me/projects/api "uvicorn app.main:app --reload --port 8000"
+
+# A long-running integration test with output captured to a log
+gitdirector gd-tmux /Users/me/projects/myrepo "pytest -x -v 2>&1 | tee /tmp/test.log"
+
+# A watcher or build loop
+gitdirector gd-tmux /Users/me/projects/myrepo "npm run watch"
+
+# A repo whose directory name contains a space — quote both the path and the command
+gitdirector gd-tmux "/Users/me/projects/My Repo" "npm run dev"
+```
+
+The by-name form is supported for ergonomic use by humans in interactive shells, but agents should default to the absolute path to avoid any chance of matching the wrong repo.
+
+Rules of thumb:
+
+- **Use the absolute path.** It is unambiguous and survives the user renaming or moving the directory. The by-name form is convenient shorthand, not a slug — it is the raw directory name, case-sensitive.
+- **Repo names with spaces, dots, or punctuation are matched verbatim** when you do use the by-name form. A repo at `/Users/me/My Repo` is matched by `"My Repo"`, not by `My` or `Repo`. Quote the name to keep the shell from splitting it.
+- **Quoting the command matters.** The command string is handed to `sh -lc` inside the new session, so write it as a single quoted string. `'echo "hi"'` (single-quote outer, double-quote inner) is the safest pattern for embedded double quotes.
+- **Path separators in the command are fine.** Commands like `python /path/to/script.py` or `find . -name foo/bar` work; the command is embedded verbatim into the inner shell, while the session-name label is auto-sanitized.
+- **The session self-destructs** when the command exits (success or failure), so you do not need to clean it up.
+- **If you need to capture output**, redirect it to a file in the command itself (`> /tmp/out 2>&1`) and read the file later — the session is gone once the command exits.
+- **If the user asks you to stop a running process**, kill the matching session: `gitdirector console` → Sessions tab, or directly with `tmux kill-session -t =<session-name>`.
+
 ## Configuration
 
 Config is stored at `~/.gitdirector/config.yaml`.

{gitdirector-1.4.5 → gitdirector-1.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "gitdirector"
-version = "1.4.5"
+version = "1.5.2"
 description = "A terminal based control plane for developers working across multiple repositories. Launch multiple AI coding agents, multiple tmux sessions and track changes across all your repos in one place."
 readme = "README.md"
 license = { text = "MIT" }

{gitdirector-1.4.5 → gitdirector-1.5.2}/src/gitdirector/cli.py

@@ -10,6 +10,7 @@ from .commands import (
     autoclean,
     cd,
     console,
+    gd_tmux,
     help,
     info,
     link,
@@ -55,6 +56,7 @@ help.register(cli)
 tui.register(cli)
 autoclean.register(cli)
 info.register(cli)
+gd_tmux.register(cli)
 
 
 def main():

gitdirector-1.5.2/src/gitdirector/commands/autoclean.py

@@ -0,0 +1,39 @@
+import click
+
+from ..config import Config
+from . import console
+
+
+def register(cli: click.Group):
+    @cli.command()
+    def autoclean():
+        _autoclean_links()
+
+
+def _autoclean_links():
+    config = Config()
+    broken = [p for p in config.repositories if not p.exists()]
+
+    if not broken:
+        console.print()
+        console.print("  [green]All links are valid.[/green]")
+        console.print()
+        return
+
+    console.print()
+    console.print(f"  Found [yellow]{len(broken)}[/yellow] broken link(s):\n")
+    for p in broken:
+        console.print(f"  [red]✕[/red] {p}", soft_wrap=True)
+    console.print()
+
+    if not click.confirm("  Remove these broken links?"):
+        console.print()
+        console.print("  [dim]Cancelled.[/dim]")
+        console.print()
+        return
+
+    config.remove_repositories(broken)
+
+    console.print()
+    console.print(f"  [green]Removed {len(broken)} broken link(s).[/green]")
+    console.print()

gitdirector-1.5.2/src/gitdirector/commands/gd_tmux.py

@@ -0,0 +1,79 @@
+from pathlib import Path
+
+import click
+
+from ..manager import RepositoryManager
+from ..storage import normalize_repository_path
+from . import console
+
+
+def _resolve_repo(target: str) -> Path | None:
+    """Resolve *target* to a tracked repository path.
+
+    Tries the value as a filesystem path first. If no path-based match is
+    found and the value does not look path-like, falls back to looking it up
+    by repository name. Prints a rich error and returns ``None`` on missing
+    or ambiguous targets.
+    """
+    manager = RepositoryManager()
+    candidate = Path(target)
+    is_path_like = (
+        "/" in target
+        or "\\" in target
+        or target in (".", "..")
+        or candidate.is_absolute()
+        or target.startswith("~")
+        or candidate.exists()
+    )
+
+    if is_path_like:
+        normalized = normalize_repository_path(candidate)
+        if manager.config.has_repository(normalized):
+            return normalized
+        console.print(f"\n  [red]No tracked repository at path: {normalized}[/red]\n")
+        return None
+
+    matches = [r for r in manager.config.repositories if r.name == target]
+    if not matches:
+        console.print(f"\n  [red]No tracked repository named: {target}[/red]\n")
+        return None
+    if len(matches) > 1:
+        paths_list = "\n".join(f"  {p}" for p in matches)
+        console.print(
+            f"\n  [red]Multiple repositories named '{target}' — use the full path:[/red]\n"
+            f"{paths_list}\n"
+        )
+        return None
+    return matches[0]
+
+
+def register(cli: click.Group):
+    @cli.command()
+    @click.argument("target", metavar="PATH|NAME")
+    @click.argument("command")
+    def gd_tmux(target: str, command: str):
+        """Create a gd tmux session for a repository and run a command in it."""
+        if not command.strip():
+            console.print("\n  [red]Command must not be empty.[/red]\n")
+            raise SystemExit(1)
+
+        repo_path = _resolve_repo(target)
+        if repo_path is None:
+            raise SystemExit(1)
+
+        try:
+            from ..integrations.tmux import (
+                attach_tmux_session,
+                create_tmux_session,
+                launch_command_in_tmux_session,
+            )
+        except ImportError:
+            console.print(
+                "\n  [red]The tmux integration is unavailable for the gd-tmux command.[/red]\n"
+                "  Reinstall gitdirector or check your installation.\n"
+            )
+            raise SystemExit(1)
+
+        session_name = create_tmux_session(repo_path.name, repo_path, purpose=command)
+        launch_command_in_tmux_session(session_name, command)
+        attach_tmux_session(session_name, skip_config_sync=True)

{gitdirector-1.4.5 → gitdirector-1.5.2}/src/gitdirector/commands/help.py

@@ -32,8 +32,9 @@ def show_help():
         ("pull", "Pull latest changes for all tracked repositories"),
         ("cd NAME", "Open or switch to a tmux session for a repository"),
         ("console", "Interactive TUI for browsing and opening repositories"),
-        ("autoclean links|sessions", "Clean broken links or stale tmux sessions"),
+        ("autoclean", "Remove broken repository links from tracking"),
         ("info PATH|NAME [--full]", "Show file statistics for a repository"),
+        ('gd-tmux PATH|NAME "cmd"', "Create a gd tmux session and run a command in it"),
         ("help", "Show this help message"),
     ]:
         cmd_table.add_row(cmd, desc)

{gitdirector-1.4.5 → gitdirector-1.5.2}/src/gitdirector/commands/tui/__init__.py

@@ -14,20 +14,24 @@ from .constants import (
 )
 from .panel_view import PanelViewScreen, PaneWidget
 from .panels import Panel, PanelStore
-from .screens import (
-    ActionMenuScreen,
+from .screens import SortMenuScreen
+from .screens.diff import DiffReviewScreen
+from .screens.panels import (
     AgentLoadingScreen,
     ConfirmScreen,
     CreatePanelScreen,
+    PanelActionMenuScreen,
+    RenamePanelScreen,
+)
+from .screens.repos import (
+    ActionMenuScreen,
     GitCommandResultScreen,
     GitOperationsMenuScreen,
     PullLoadingScreen,
     PullResultScreen,
-    RemoveSessionScreen,
     RepoInfoScreen,
-    SelectSessionScreen,
-    SortMenuScreen,
 )
+from .screens.sessions import RemoveSessionScreen, SelectSessionScreen
 from .terminal_widget import TerminalWidget
 
 __all__ = [
@@ -35,18 +39,21 @@ __all__ = [
     "AgentLoadingScreen",
     "ConfirmScreen",
     "CreatePanelScreen",
+    "DiffReviewScreen",
     "GitCommandResultScreen",
     "GitOperationsMenuScreen",
     "_DEFAULT_PANELS_SORT_COLUMN",
     "GitDirectorConsole",
     "PaneWidget",
     "Panel",
+    "PanelActionMenuScreen",
     "PanelStore",
     "PanelViewScreen",
     "_PANELS_SORT_COLUMN_NAMES",
     "PullLoadingScreen",
     "PullResultScreen",
     "RemoveSessionScreen",
+    "RenamePanelScreen",
     "RepoInfoScreen",
     "SelectSessionScreen",
     "SortMenuScreen",

{gitdirector-1.4.5 → gitdirector-1.5.2}/src/gitdirector/commands/tui/app.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import logging
 from concurrent.futures import ThreadPoolExecutor
 from pathlib import Path
 from typing import Callable
@@ -31,17 +32,17 @@ from .constants import (
     _SESSION_STATUS_POLL_INTERVAL_SECS,
 )
 from .panels import Panel, PanelStore
-from .screens import (
+from .screens.diff import DiffReviewScreen
+from .screens.panels import AgentLoadingScreen, ConfirmScreen
+from .screens.repos import (
     ActionMenuScreen,
-    AgentLoadingScreen,
-    ConfirmScreen,
     GitCommandResultScreen,
     GitOperationsMenuScreen,
     PullLoadingScreen,
     PullResultScreen,
-    RemoveSessionScreen,
     RepoInfoScreen,
 )
+from .screens.sessions import RemoveSessionScreen
 
 _panel_row_height = _app_panels._panel_row_height
 _render_panel_preview = _app_panels._render_panel_preview
@@ -55,6 +56,9 @@ __all__ = [
 ]
 
 
+logger = logging.getLogger(__name__)
+
+
 class GitDirectorConsole(
     ConsolePanelsMixin,
     ConsoleSessionsMixin,
@@ -355,25 +359,32 @@ class GitDirectorConsole(
         if path is None:
             return
 
-        from ...integrations.tmux import create_tmux_session, launch_agent_in_tmux_session
+        from ...integrations.tmux import create_tmux_session, launch_command_in_tmux_session
 
         purpose = agent_cmd if agent_cmd else "shell"
         session_name = create_tmux_session(path.name, path, purpose=purpose)
 
         if agent_cmd:
-            ready_marker = launch_agent_in_tmux_session(session_name, agent_cmd)
+            ready_marker = launch_command_in_tmux_session(session_name, agent_cmd)
             self.push_screen(
                 AgentLoadingScreen(agent_cmd, session_name, ready_marker),
                 callback=lambda _: self.set_timer(0.2, lambda: self._refresh_repo_for_path(path)),
             )
         else:
-            self._suspend_and_attach(session_name, path)
+            # create_tmux_session already called sync_panel_tmux_config, so skip
+            # the redundant sync in attach_tmux_session. Without this skip the
+            # sync re-lists every tmux session, rewrites gd-tmux.conf, and runs
+            # `tmux source-file` between the manual screen clear and tmux's
+            # first redraw — long enough to expose a visible empty alt-screen.
+            self._suspend_and_attach(session_name, path, skip_config_sync=True)
 
     def _suspend_and_attach(
         self,
         session_name: str,
         path: Path | None = None,
         row_key: str | None = None,
+        *,
+        skip_config_sync: bool = False,
     ) -> None:
         """Suspend the TUI and attach to the tmux session."""
         import sys
@@ -402,7 +413,7 @@ class GitDirectorConsole(
             with self.suspend():
                 sys.stdout.write("\033[?1049h\033[H\033[2J\033[?25l")
                 sys.stdout.flush()
-                attach_tmux_session(session_name)
+                attach_tmux_session(session_name, skip_config_sync=skip_config_sync)
                 sys.stdout.write("\033[?25h")
                 sys.stdout.flush()
                 try:
@@ -650,10 +661,27 @@ class GitDirectorConsole(
 
         from ..pull import pull_repository
 
-        result = pull_repository(path)
+        try:
+            result = pull_repository(path)
+        except Exception as exc:
+            logger.exception("pull worker crashed")
+            error_result = (path.name, False, f"Pull failed: {exc}")
+            if self._background_shutdown_requested(worker):
+                return
+            try:
+                self.call_from_thread(
+                    self._show_pull_result, loading_screen, path, command, error_result
+                )
+            except Exception:
+                logger.debug("Failed to post pull error to UI", exc_info=True)
+            return
+
         if self._background_shutdown_requested(worker):
             return
-        self.call_from_thread(self._show_pull_result, loading_screen, path, command, result)
+        try:
+            self.call_from_thread(self._show_pull_result, loading_screen, path, command, result)
+        except Exception:
+            logger.debug("Failed to post pull result to UI", exc_info=True)
 
     def _show_pull_result(
         self,
@@ -677,6 +705,7 @@ class GitDirectorConsole(
         "agent:claude": "claude",
         "agent:copilot": "copilot",
         "agent:codex": "codex",
+        "agent:pi": "pi",
     }
 
     def _handle_menu_action(self, action: str | None) -> None:
@@ -690,6 +719,8 @@ class GitDirectorConsole(
             session_name = action[len("attach:") :]
             path = self._get_selected_path()
             self._attach_to_session(session_name, path)
+        elif action == "review_diff":
+            self._open_review_diff()
         elif action == "remove_session":
             path = self._get_selected_path()
             if path:
@@ -698,6 +729,14 @@ class GitDirectorConsole(
                     callback=self._handle_remove_selection,
                 )
 
+    def _open_review_diff(self) -> None:
+        path = self._get_selected_path()
+        if path is None:
+            return
+        info = self._results.get(str(path))
+        branch = info.branch if info else None
+        self.push_screen(DiffReviewScreen(path.name, path, branch=branch))
+
     def _handle_remove_selection(self, session_name: str | None) -> None:
         if session_name is None:
             return

{gitdirector-1.4.5 → gitdirector-1.5.2}/src/gitdirector/commands/tui/app_panels.py

@@ -12,7 +12,12 @@ from .constants import (
     _PANELS_SORT_COLUMN_NAMES,
 )
 from .panels import Panel, render_panel_layout_preview
-from .screens import ConfirmScreen, CreatePanelScreen, PanelActionMenuScreen, RenamePanelScreen
+from .screens.panels import (
+    ConfirmScreen,
+    CreatePanelScreen,
+    PanelActionMenuScreen,
+    RenamePanelScreen,
+)
 
 _PANEL_PREVIEW_FILLED = "■"
 _PANEL_PREVIEW_OPEN = "□"