thwip-cli 1.0.0__tar.gz → 1.0.2__tar.gz

thwip_cli-1.0.2/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI and GitHub Releases
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies and test
+        run: |
+          uv sync --all-extras
+          uv run pytest
+
+  build-and-publish:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+        continue-on-error: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: dist/*
+          generate_release_notes: true

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thwip-cli
-Version: 1.0.0
+Version: 1.0.2
 Summary: Universal coding agent multiplexer: detect, switch, and route between AI coding agents seamlessly
 Project-URL: Homepage, https://github.com/tanmayhutt/thwip-cli
 Project-URL: Repository, https://github.com/tanmayhutt/thwip-cli

thwip_cli-1.0.2/install.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Install script for thwip (Universal Coding Agent Multiplexer)
+set -e
+
+echo "Installing thwip..."
+
+if command -v uv &> /dev/null; then
+    echo "Installing via uv tool..."
+    uv tool install --force thwip-cli
+elif command -v pipx &> /dev/null; then
+    echo "Installing via pipx..."
+    pipx install --force thwip-cli
+elif command -v pip3 &> /dev/null; then
+    echo "Installing via pip3..."
+    pip3 install --upgrade thwip-cli
+else
+    echo "Error: Neither uv, pipx, nor pip3 was found on your system."
+    echo "Please install Python (>= 3.11) or uv to use thwip."
+    exit 1
+fi
+
+echo "thwip installed successfully. Run 'thwip' to get started."

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thwip-cli"
-version = "1.0.0"
+version = "1.0.2"
 description = "Universal coding agent multiplexer: detect, switch, and route between AI coding agents seamlessly"
 readme = "README.md"
 license = "MIT"

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/__init__.py

@@ -1,4 +1,4 @@
 """thwip: Universal Coding Agent Multiplexer."""
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"
 __app_name__ = "thwip"

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/agents/base.py

@@ -301,7 +301,7 @@ class BaseAgent(ABC):
         if not self.is_installed():
             return ("Not Installed", "dim")
         if not self.is_configured():
-            return ("No Key", "status.no_key")
+            return ("Installed (No Key)", "status.limited")
 
         limit = self.check_limits()
         if limit == LimitStatus.OK:
@@ -315,7 +315,7 @@ class BaseAgent(ABC):
         elif limit == LimitStatus.INVALID_KEY:
             return ("Invalid Key", "error")
         else:
-            return ("Unknown", "dim")
+            return ("Installed", "status.ready")
 
     def to_table_row(self) -> dict:
         """Convert to a dict suitable for render_agents_table()."""

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/agents/claude_agent.py

@@ -149,8 +149,17 @@ class ClaudeAgent(BaseAgent):
     # --- Detection ---
 
     def is_installed(self) -> bool:
-        """Check if Claude Code CLI is installed or configured."""
-        return shutil.which("claude") is not None or self.is_configured()
+        """Check if Claude Code CLI or Claude desktop app is installed or configured."""
+        if self.is_configured():
+            return True
+        if shutil.which("claude") is not None:
+            return True
+        app_paths = [
+            Path("/Applications/Claude.app"),
+            Path.home() / "Applications" / "Claude.app",
+            Path.home() / ".claude",
+        ]
+        return any(p.exists() for p in app_paths)
 
     def is_configured(self) -> bool:
         """Check if we have a valid Anthropic API key."""
@@ -166,7 +175,7 @@ class ClaudeAgent(BaseAgent):
         path = shutil.which("claude")
         if path:
             info["path"] = path
-            info["method"] = "npm global"  # Claude Code is typically installed via npm
+            info["method"] = "CLI binary"
 
             # Try to get version
             try:
@@ -179,6 +188,19 @@ class ClaudeAgent(BaseAgent):
             except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
                 pass
 
+        if not info["path"]:
+            app_paths = [
+                Path("/Applications/Claude.app"),
+                Path.home() / "Applications" / "Claude.app",
+                Path.home() / ".claude",
+            ]
+            for app in app_paths:
+                if app.exists():
+                    info["method"] = "macOS config" if app.name == ".claude" else "macOS app"
+                    info["path"] = str(app)
+                    info["version"] = "Installed"
+                    break
+
         self._install_cache = info
         return info
 

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/agents/google_agent.py

@@ -134,11 +134,20 @@ class GoogleAgent(BaseAgent):
     # --- Detection ---
 
     def is_installed(self) -> bool:
-        """Check if Gemini CLI, Antigravity, or API is configured."""
-        return self.is_configured() or any(
-            shutil.which(cmd) is not None
-            for cmd in ("gemini", "agy", "antigravity")
-        )
+        """Check if Gemini CLI, Antigravity IDE, or Gemini app is installed."""
+        if self.is_configured():
+            return True
+        if any(shutil.which(cmd) is not None for cmd in ("gemini", "agy", "antigravity")):
+            return True
+        app_paths = [
+            Path("/Applications/Antigravity IDE.app"),
+            Path("/Applications/Antigravity.app"),
+            Path("/Applications/Gemini.app"),
+            Path.home() / "Applications" / "Antigravity IDE.app",
+            Path.home() / "Applications" / "Antigravity.app",
+            Path.home() / ".gemini",
+        ]
+        return any(p.exists() for p in app_paths)
 
     def is_configured(self) -> bool:
         return bool(self._get_api_key())
@@ -150,7 +159,7 @@ class GoogleAgent(BaseAgent):
             path = shutil.which(cmd)
             if path:
                 info["path"] = path
-                info["method"] = "npm global" if cmd == "gemini" else "binary"
+                info["method"] = "CLI binary"
                 try:
                     result = subprocess.run(
                         [cmd, "--version"],
@@ -162,16 +171,20 @@ class GoogleAgent(BaseAgent):
                     pass
                 break
 
-        # Also check for Antigravity IDE (macOS app)
+        # Also check for Antigravity IDE or Gemini app (macOS app)
         if not info["path"]:
             app_paths = [
+                Path("/Applications/Antigravity IDE.app"),
                 Path("/Applications/Antigravity.app"),
+                Path("/Applications/Gemini.app"),
+                Path.home() / "Applications" / "Antigravity IDE.app",
                 Path.home() / "Applications" / "Antigravity.app",
             ]
             for app in app_paths:
                 if app.exists():
                     info["method"] = "macOS app"
                     info["path"] = str(app)
+                    info["version"] = "Installed"
                     break
 
         return info

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/agents/openai_agent.py

@@ -157,10 +157,18 @@ class OpenAIAgent(BaseAgent):
     # --- Detection ---
 
     def is_installed(self) -> bool:
-        return self.is_configured() or any(
-            shutil.which(cmd) is not None
-            for cmd in ("codex", "openai")
-        )
+        """Check if Codex CLI, OpenAI CLI, or ChatGPT app is installed."""
+        if self.is_configured():
+            return True
+        if any(shutil.which(cmd) is not None for cmd in ("codex", "openai", "chatgpt")):
+            return True
+        app_paths = [
+            Path("/Applications/ChatGPT.app"),
+            Path("/Applications/OpenAI.app"),
+            Path.home() / "Applications" / "ChatGPT.app",
+            Path.home() / ".config" / "openai",
+        ]
+        return any(p.exists() for p in app_paths)
 
     def is_configured(self) -> bool:
         return bool(self._get_api_key())
@@ -168,11 +176,11 @@ class OpenAIAgent(BaseAgent):
     def get_install_info(self) -> dict[str, str]:
         info: dict[str, str] = {"method": "not installed", "path": "", "version": ""}
 
-        for cmd in ("codex", "openai"):
+        for cmd in ("codex", "openai", "chatgpt"):
             path = shutil.which(cmd)
             if path:
                 info["path"] = path
-                info["method"] = "npm global" if cmd == "codex" else "pip"
+                info["method"] = "CLI binary"
                 try:
                     result = subprocess.run(
                         [cmd, "--version"],
@@ -184,6 +192,20 @@ class OpenAIAgent(BaseAgent):
                     pass
                 break
 
+        # Also check for ChatGPT macOS app
+        if not info["path"]:
+            app_paths = [
+                Path("/Applications/ChatGPT.app"),
+                Path("/Applications/OpenAI.app"),
+                Path.home() / "Applications" / "ChatGPT.app",
+            ]
+            for app in app_paths:
+                if app.exists():
+                    info["method"] = "macOS app"
+                    info["path"] = str(app)
+                    info["version"] = "Installed"
+                    break
+
         return info
 
     def get_subscription_info(self) -> SubscriptionInfo:

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/cli.py

@@ -53,6 +53,7 @@ from thwip.theme import (
     print_info,
     print_success,
     print_warning,
+    render_about_guide,
     render_agent_badge,
     render_agents_table,
     render_capability_disclaimer,
@@ -182,6 +183,9 @@ class ThwipCLI:
         if cmd in ("/quit", "/exit", "/q"):
             return "QUIT"
 
+        elif cmd in ("/about", "/guide", "/info"):
+            self.cmd_show_about()
+
         elif cmd in ("/help", "/h"):
             self.show_help()
 
@@ -194,6 +198,9 @@ class ThwipCLI:
         elif cmd in ("/models", "/m"):
             self.cmd_show_models(arg1)
 
+        elif cmd == "/tools":
+            self.cmd_show_tools()
+
         elif cmd == "/status":
             self.cmd_show_status()
 
@@ -206,6 +213,10 @@ class ThwipCLI:
         elif cmd == "/history":
             self.cmd_show_history()
 
+        elif cmd in ("/clear", "/reset"):
+            self.session.messages.clear()
+            print_info("Conversation history cleared.")
+
         elif cmd == "/cost":
             self.cmd_show_cost()
 
@@ -236,10 +247,47 @@ class ThwipCLI:
                 print_info("Usage: /session [save|load|list|clear] [name]")
 
         else:
-            print_warning(f"Unknown command '{cmd}'. Type /help for available commands.")
+            print_warning(f"Unknown command '{cmd}'. Type /help or /about for navigation guide.")
 
         return None
 
+    def cmd_show_about(self) -> None:
+        """Display the complete About section and navigation guide."""
+        detected = len(self.detector.scan_all())
+        ready = len(self.registry.get_ready_agents())
+        console.print(
+            render_about_guide(
+                agents_detected=detected,
+                agents_ready=ready,
+                active_agent=self.current_agent.display_name,
+                active_model=self.session.current_model,
+                active_company=self.current_agent.company,
+            )
+        )
+
+    def cmd_show_tools(self) -> None:
+        """Display available universal tools."""
+        table = Table(title="Universal Tool Engine", box=box.ROUNDED)
+        table.add_column("Tool Name", style="bold white")
+        table.add_column("Category", style="cyan")
+        table.add_column("Description", style="white")
+        table.add_column("Status", style="green")
+
+        tools_info = [
+            ("read_file", "Filesystem", "Read file contents with line offset controls", "Active"),
+            ("edit_file", "Filesystem", "Structured string replacement in local files", "Active"),
+            ("write_file", "Filesystem", "Create or overwrite full files", "Active"),
+            ("list_dir", "Filesystem", "List directory tree and metadata", "Active"),
+            ("run_command", "Terminal", "Execute non-interactive shell commands safely", "Active"),
+            ("run_code", "Sandbox", "Run inline Python or Node.js code snippets", "Active"),
+            ("git_status", "Version Control", "Inspect repository changes and staging", "Active"),
+            ("git_diff", "Version Control", "View unified unstaged/staged diffs", "Active"),
+            ("git_commit", "Version Control", "Commit staged workspace changes", "Active"),
+        ]
+        for name, cat, desc, status in tools_info:
+            table.add_row(name, cat, desc, f"[bold green]{status}[/bold green]")
+        console.print(table)
+
     def show_help(self) -> None:
         """Show help information."""
         table = Table(title="thwip Commands & Shortcuts", box=box.ROUNDED)
@@ -247,22 +295,24 @@ class ThwipCLI:
         table.add_column("Description", style="white")
 
         commands = [
+            ("/about", "Display full About section, architecture, and navigation guide"),
             ("/switch [agent] [model]", "Switch active agent/model mid-conversation without losing context"),
             ("/agents", "Show all detected coding agents, company status & capabilities"),
             ("/models [agent]", "List available models for current or target agent"),
+            ("/tools", "List all universal file, terminal, and git tools"),
             ("/status", "Display current session, project, and token stats"),
             ("/limits", "View token usage, quota, and spend metrics"),
             ("/detect", "Re-scan system for newly installed coding agents"),
             ("/session save [name]", "Save current chat session"),
             ("/session load <name>", "Load a previously saved session"),
             ("/session list", "List all saved sessions"),
-            ("/session clear", "Clear current conversation memory"),
+            ("/clear", "Clear current conversation memory"),
             ("/history", "View conversation history with model attribution badges"),
             ("/cost", "Show estimated session and cumulative cost"),
             ("/project [path]", "View or change project working directory"),
-            ("Ctrl + S", "Quick switch prompt"),
-            ("Ctrl + T", "Status view"),
-            ("Ctrl + H", "Show conversation history"),
+            ("Ctrl + S", "Interactive agent/model switcher prompt"),
+            ("Ctrl + T", "Status view and token counters"),
+            ("Ctrl + C", "Interrupt active response or tool execution"),
             ("/quit", "Exit thwip"),
         ]
         for c, d in commands:
@@ -272,21 +322,32 @@ class ThwipCLI:
     async def cmd_switch(self, agent_name: str, model_id: str = "") -> None:
         """Switch to a different agent and/or model."""
         if not agent_name:
-            # Interactive selection
             agents = self.registry.list_agents()
-            console.print("\n[bold white]Select an agent to switch to:[/bold white]")
-            for i, a in enumerate(agents, 1):
+            console.print("\n[bold white]Available Coding Agents on Your Machine:[/bold white]")
+
+            # Group: Ready / Configured
+            ready_agents = [a for a in agents if a.is_configured()]
+            installed_agents = [a for a in agents if a.is_installed() and not a.is_configured()]
+            other_agents = [a for a in agents if not a.is_installed()]
+
+            ordered = ready_agents + installed_agents + other_agents
+
+            for i, a in enumerate(ordered, 1):
                 brand = get_brand(a.company)
-                status_str, _ = a.get_status_display()
-                caps_str = ", ".join(c.value for c in a.capabilities)
+                status_str, status_style = a.get_status_display()
+                install_info = a.get_install_info()
+                loc = f" ({install_info['path']})" if install_info.get("path") else ""
+
                 console.print(
                     f"  [bold white]{i}.[/bold white] [bold]{a.display_name}[/bold] "
-                    f"({a.company}) - [{status_str}] - [dim]{caps_str}[/dim]"
+                    f"({a.company}) - [{status_style}][{status_str}][/{status_style}][dim]{loc}[/dim]"
                 )
 
-            choice = input(f"\nEnter choice [1-{len(agents)}]: ").strip()
-            if choice.isdigit() and 1 <= int(choice) <= len(agents):
-                agent_name = agents[int(choice) - 1].name
+            choice = input(f"\nEnter choice [1-{len(ordered)}]: ").strip()
+            if choice.isdigit() and 1 <= int(choice) <= len(ordered):
+                agent_name = ordered[int(choice) - 1].name
+            elif choice.lower() in [a.name for a in agents]:
+                agent_name = choice.lower()
             else:
                 print_warning("Switch cancelled.")
                 return
@@ -313,7 +374,23 @@ class ThwipCLI:
                 unsupported=missing,
             )
         )
-        print_success(f"Now chatting with {new_agent.display_name} ({chosen_model}). Context preserved!")
+
+        if not new_agent.is_configured():
+            key_name = {
+                "google": "GEMINI_API_KEY",
+                "openai": "OPENAI_API_KEY",
+                "claude": "ANTHROPIC_API_KEY",
+                "deepseek": "DEEPSEEK_API_KEY",
+                "groq": "GROQ_API_KEY",
+                "openrouter": "OPENROUTER_API_KEY",
+            }.get(new_agent.name, "API_KEY")
+            print_warning(
+                f"Notice: {new_agent.display_name} was selected, but no API key was found.\n"
+                f"  Set your key with: export {key_name}=your_key_here\n"
+                f"  Or add it to ~/.thwip/config.toml"
+            )
+        else:
+            print_success(f"Now chatting with {new_agent.display_name} ({chosen_model}). Context preserved!")
 
     def cmd_show_agents(self) -> None:
         """Show table of all detected agents."""

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/detector.py

@@ -96,6 +96,27 @@ KNOWN_CLI_TOOLS: list[dict[str, Any]] = [
 ]
 
 KNOWN_APPS: list[dict[str, Any]] = [
+    {
+        "name": "Antigravity IDE",
+        "company": "Google",
+        "mac_path": "/Applications/Antigravity IDE.app",
+        "category": "IDE App",
+        "capabilities": ["Chat", "File Edit", "Terminal", "Browser", "Search"],
+    },
+    {
+        "name": "ChatGPT Desktop",
+        "company": "OpenAI",
+        "mac_path": "/Applications/ChatGPT.app",
+        "category": "Desktop App",
+        "capabilities": ["Chat", "Code Run", "Vision"],
+    },
+    {
+        "name": "Gemini Desktop",
+        "company": "Google",
+        "mac_path": "/Applications/Gemini.app",
+        "category": "Desktop App",
+        "capabilities": ["Chat", "Search", "Vision"],
+    },
     {
         "name": "Cursor",
         "company": "Cursor Inc",

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/thwip/theme.py

@@ -130,27 +130,51 @@ def render_startup_banner(
     agents_detected: int,
     agents_ready: int,
 ) -> Panel:
-    """Render the startup banner with current agent info."""
+    """Render the startup banner with ASCII logo and current agent info."""
     brand = get_brand(company)
 
     lines = Text()
-    lines.append("thwip", style="bold white")
-    lines.append(" v1.0\n", style="dim")
-    lines.append("Universal Coding Agent Multiplexer\n\n", style="dim italic")
-    lines.append("  Agent:    ", style="dim")
+    # Web sign + Wordmark logo in exact website theme
+    lines.append("        \\  |  /        ", style="bold #8E8B8B")
+    lines.append("████████╗██╗  ██╗██╗    ██╗██╗██████╗ \n", style="bold #F1ECEC")
+    lines.append("      -- \\ | / --      ", style="bold #8E8B8B")
+    lines.append("╚══██╔══╝██║  ██║██║    ██║██║██╔══██╗\n", style="bold #4285F4")
+    lines.append("     - - <(", style="bold #8E8B8B")
+    lines.append("●", style="bold #FFFFFF")
+    lines.append(")> - -        ", style="bold #8E8B8B")
+    lines.append("██║   ███████║██║ █╗ ██║██║██████╔╝\n", style="bold #D97757")
+    lines.append("      -- / | \\ --         ", style="bold #8E8B8B")
+    lines.append("██║   ██╔══██║██║███╗██║██║██╔═══╝ \n", style="bold #10A37F")
+    lines.append("        /  |  \\           ", style="bold #8E8B8B")
+    lines.append("██║   ██║  ██║╚███╔███╔╝██║██║     \n", style="bold #F1ECEC")
+    lines.append("                          ", style="bold #8E8B8B")
+    lines.append("╚═╝   ╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝╚═╝     \n\n", style="dim")
+
+    lines.append("  Universal Coding Agent Multiplexer", style="bold white")
+    lines.append("  v1.0.2\n\n", style="dim")
+    lines.append("  Agent:       ", style="dim")
     lines.append(f"{agent_name}", style=brand.label_style)
     lines.append(f" ({company})\n", style="dim")
-    lines.append("  Model:    ", style="dim")
+    lines.append("  Model:       ", style="dim")
     lines.append(f"{model}\n", style="bold white")
-    lines.append("  Project:  ", style="dim")
+    lines.append("  Workspace:   ", style="dim")
     lines.append(f"{project_path}\n", style="white")
-    lines.append("  Session:  ", style="dim")
+    lines.append("  Session:     ", style="dim")
     lines.append(f"{session_name}\n", style="white")
-    lines.append("  Agents:   ", style="dim")
+    lines.append("  Environment: ", style="dim")
     lines.append(f"{agents_detected}", style="bold white")
-    lines.append(" detected, ", style="dim")
+    lines.append(" tools detected, ", style="dim")
     lines.append(f"{agents_ready}", style="success")
-    lines.append(" ready", style="dim")
+    lines.append(" ready\n\n", style="dim")
+    lines.append("  Quickstart:  Type ", style="dim")
+    lines.append("/about", style="bold cyan")
+    lines.append(" for guide, ", style="dim")
+    lines.append("/switch", style="bold cyan")
+    lines.append(" to change agent, ", style="dim")
+    lines.append("/agents", style="bold cyan")
+    lines.append(" to list tools, ", style="dim")
+    lines.append("Ctrl+S", style="bold yellow")
+    lines.append(" for switcher.", style="dim")
 
     return Panel(
         lines,
@@ -160,6 +184,56 @@ def render_startup_banner(
     )
 
 
+def render_about_guide(
+    agents_detected: int = 0,
+    agents_ready: int = 0,
+    active_agent: str = "",
+    active_model: str = "",
+    active_company: str = "",
+) -> Panel:
+    """Render comprehensive about section and navigation guide."""
+    brand = get_brand(active_company)
+    content = Text()
+
+    content.append("thwip - Universal Coding Agent Multiplexer\n", style="bold white")
+    content.append("Combine, switch, and route across installed AI coding agents seamlessly.\n\n", style="dim")
+
+    content.append("HOW IT WORKS\n", style="bold cyan")
+    content.append("  1. Auto-Detection:   Scans environment variables, local CLI agents, and existing credentials\n", style="dim")
+    content.append("                       in ~/.claude.json, ~/.gemini/config.json, ~/.config/openai/, or Ollama.\n", style="dim")
+    content.append("  2. Unified State:    Maintains conversation history and tool outputs in a portable format.\n", style="dim")
+    content.append("  3. Hot-Swapping:     Switch models mid-conversation with zero context loss.\n", style="dim")
+    content.append("  4. Universal Tools:  Provides safe file editing, shell commands, execution, and git operations.\n", style="dim")
+    content.append("  5. Quota Failover:   Catches HTTP 429 errors and offers immediate one-key fallback switching.\n\n", style="dim")
+
+    content.append("NAVIGATION & COMMANDS\n", style="bold cyan")
+    content.append("  /switch <agent> [model]  Hot-swap active model mid-conversation (e.g. /switch google gemini-2.5-pro)\n", style="white")
+    content.append("  /agents                  List all discovered agents, status, and capabilities\n", style="white")
+    content.append("  /models [agent]          Show available models and context window limits\n", style="white")
+    content.append("  /limits                  View live token counts, cumulative costs, and quotas\n", style="white")
+    content.append("  /tools                   List all universal file, execution, and git tools\n", style="white")
+    content.append("  /session save <name>     Save current conversation to disk\n", style="white")
+    content.append("  /session load <name>     Restore and continue a saved session\n", style="white")
+    content.append("  /history                 View turn summary across models\n", style="white")
+    content.append("  /about or /guide         Display this navigation guide anytime\n", style="white")
+    content.append("  /clear                   Reset conversation memory\n", style="white")
+    content.append("  /exit or /quit           Exit the REPL\n\n", style="white")
+
+    content.append("KEYBOARD SHORTCUTS\n", style="bold cyan")
+    content.append("  Ctrl+S                   Interactive model switcher prompt\n", style="white")
+    content.append("  Ctrl+T                   Display current agent status and token counters\n", style="white")
+    content.append("  Ctrl+C                   Interrupt current response or tool execution\n", style="white")
+
+    return Panel(
+        content,
+        title="About & Navigation Guide",
+        title_align="left",
+        border_style=brand.primary,
+        box=box.ROUNDED,
+        padding=(1, 2),
+    )
+
+
 def render_agent_badge(agent_name: str, model: str, company: str) -> Text:
     """Render an inline badge for message attribution."""
     brand = get_brand(company)

{thwip_cli-1.0.0 → thwip_cli-1.0.2}/uv.lock

@@ -1021,8 +1021,8 @@ wheels = [
 ]
 
 [[package]]
-name = "thwip"
-version = "1.0.0"
+name = "thwip-cli"
+version = "1.0.2"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },