shotgun-sh 0.7.2.dev2__tar.gz → 0.7.3.dev1__tar.gz

{shotgun_sh-0.7.2.dev2 → shotgun_sh-0.7.3.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shotgun-sh
-Version: 0.7.2.dev2
+Version: 0.7.3.dev1
 Summary: AI-powered research, planning, and task management CLI tool
 Project-URL: Homepage, https://shotgun.sh/
 Project-URL: Repository, https://github.com/shotgun-sh/shotgun

{shotgun_sh-0.7.2.dev2 → shotgun_sh-0.7.3.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shotgun-sh"
-version = "0.7.2.dev2"
+version = "0.7.3.dev1"
 description = "AI-powered research, planning, and task management CLI tool"
 readme = "README.md"
 license = { text = "MIT" }

{shotgun_sh-0.7.2.dev2 → shotgun_sh-0.7.3.dev1}/src/shotgun/tui/screens/chat/chat_screen.py

@@ -100,6 +100,8 @@ from shotgun.tui.screens.chat.codebase_index_prompt_screen import (
 )
 from shotgun.tui.screens.chat.codebase_index_selection import CodebaseIndexSelection
 from shotgun.tui.screens.chat.help_text import (
+    GETTING_STARTED_LINK,
+    GETTING_STARTED_LINK_TEXT,
     help_text_empty_dir,
     help_text_with_codebase,
 )
@@ -502,16 +504,28 @@ class ChatScreen(Screen[None]):
             await self.codebase_sdk.list_codebases_for_directory()
         ).graphs
         if accessible_graphs:
-            self.mount_hint(help_text_with_codebase(already_indexed=True))
+            self.mount_hint(
+                help_text_with_codebase(already_indexed=True),
+                link=GETTING_STARTED_LINK,
+                link_text=GETTING_STARTED_LINK_TEXT,
+            )
             return
 
         # Ask user if they want to index the current directory
         should_index = await self.app.push_screen_wait(CodebaseIndexPromptScreen())
         if not should_index:
-            self.mount_hint(help_text_empty_dir())
+            self.mount_hint(
+                help_text_empty_dir(),
+                link=GETTING_STARTED_LINK,
+                link_text=GETTING_STARTED_LINK_TEXT,
+            )
             return
 
-        self.mount_hint(help_text_with_codebase(already_indexed=False))
+        self.mount_hint(
+            help_text_with_codebase(already_indexed=False),
+            link=GETTING_STARTED_LINK,
+            link_text=GETTING_STARTED_LINK_TEXT,
+        )
 
         # Auto-index the current directory with its name
         cwd_name = cur_dir.name
@@ -963,8 +977,14 @@ class ChatScreen(Screen[None]):
                         yield ContextIndicator(id="context-indicator")
                         yield Static("", id="indexing-job-display")
 
-    def mount_hint(self, markdown: str) -> None:
-        hint = HintMessage(message=markdown)
+    def mount_hint(
+        self,
+        markdown: str,
+        *,
+        link: str | None = None,
+        link_text: str | None = None,
+    ) -> None:
+        hint = HintMessage(message=markdown, link=link, link_text=link_text)
         self.agent_manager.add_hint_message(hint)
 
     def _show_pull_hint(self) -> None:

{shotgun_sh-0.7.2.dev2 → shotgun_sh-0.7.3.dev1}/src/shotgun/tui/screens/chat/help_text.py

@@ -1,5 +1,9 @@
 """Helper functions for chat screen help text."""
 
+# Getting started guide link shown in welcome messages
+GETTING_STARTED_LINK = "https://app.shotgun.sh/how-to-use"
+GETTING_STARTED_LINK_TEXT = "Link to Getting started guide"
+
 
 def help_text_with_codebase(already_indexed: bool = False) -> str:
     """Generate help text for when a codebase is available.

{shotgun_sh-0.7.2.dev2 → shotgun_sh-0.7.3.dev1}/src/shotgun/tui/screens/chat_screen/hint_message.py

@@ -1,3 +1,4 @@
+import webbrowser
 from typing import Literal
 
 from pydantic import BaseModel
@@ -18,6 +19,9 @@ class HintMessage(BaseModel):
     # Optional email copy functionality
     email: str | None = None
     markdown_after: str | None = None
+    # Optional link functionality
+    link: str | None = None
+    link_text: str | None = None  # Button label, defaults to "Open link"
 
 
 class HintMessageWidget(Widget):
@@ -63,6 +67,31 @@ class HintMessageWidget(Widget):
             content-align: left middle;
         }
 
+        HintMessageWidget .link-row {
+            width: auto;
+            height: auto;
+            margin: 1 0;
+        }
+
+        HintMessageWidget .link-text {
+            width: auto;
+            margin-right: 1;
+            content-align: left middle;
+        }
+
+        HintMessageWidget .link-btn {
+            width: auto;
+            min-width: 16;
+            margin-right: 1;
+        }
+
+        HintMessageWidget #link-status {
+            height: 1;
+            width: 100%;
+            margin-top: 1;
+            content-align: left middle;
+        }
+
     """
 
     def __init__(self, message: HintMessage) -> None:
@@ -87,6 +116,18 @@ class HintMessageWidget(Widget):
             if self.message.markdown_after:
                 yield Markdown(self.message.markdown_after)
 
+        # Optional link section
+        if self.message.link:
+            button_label = self.message.link_text or "Open link"
+            # Link buttons on same line
+            with Horizontal(classes="link-row"):
+                yield Static(f"{button_label}:", classes="link-text")
+                yield Button("Open in browser", id="open-link-btn", classes="link-btn")
+                yield Button("Copy link", id="copy-link-btn", classes="link-btn")
+
+            # Status feedback label for link operations
+            yield Label("", id="link-status")
+
     @on(Button.Pressed, "#copy-email-btn")
     def _copy_email(self) -> None:
         """Copy email address to clipboard when button is pressed."""
@@ -113,3 +154,45 @@ class HintMessageWidget(Widget):
         except Exception as e:
             status_label.update(f"⚠️ Copy failed: {e}")
             logger.error(f"Failed to copy email to clipboard: {e}", exc_info=True)
+
+    @on(Button.Pressed, "#open-link-btn")
+    def _open_link(self) -> None:
+        """Open link in browser when button is pressed."""
+        if not self.message.link:
+            return
+
+        status_label = self.query_one("#link-status", Label)
+
+        try:
+            webbrowser.open(self.message.link)
+            status_label.update("✓ Opened in browser!")
+            logger.debug(f"Successfully opened link in browser: {self.message.link}")
+
+        except Exception as e:
+            status_label.update(f"⚠️ Failed to open browser: {e}")
+            logger.error(f"Failed to open link in browser: {e}", exc_info=True)
+
+    @on(Button.Pressed, "#copy-link-btn")
+    def _copy_link(self) -> None:
+        """Copy link to clipboard when button is pressed."""
+        if not self.message.link:
+            return
+
+        status_label = self.query_one("#link-status", Label)
+
+        try:
+            import pyperclip
+
+            pyperclip.copy(self.message.link)
+            status_label.update("✓ Copied to clipboard!")
+            logger.debug(f"Successfully copied link to clipboard: {self.message.link}")
+
+        except ImportError:
+            status_label.update(
+                f"⚠️ Clipboard unavailable. Please manually copy: {self.message.link}"
+            )
+            logger.warning("pyperclip not available for clipboard operations")
+
+        except Exception as e:
+            status_label.update(f"⚠️ Copy failed: {e}")
+            logger.error(f"Failed to copy link to clipboard: {e}", exc_info=True)