shotgun-sh 0.2.7.dev2__tar.gz → 0.2.8.dev1__tar.gz

{shotgun_sh-0.2.7.dev2 → shotgun_sh-0.2.8.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shotgun-sh
-Version: 0.2.7.dev2
+Version: 0.2.8.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
@@ -36,6 +36,7 @@ Requires-Dist: sentencepiece>=0.2.0
 Requires-Dist: sentry-sdk[pure-eval]>=2.0.0
 Requires-Dist: tenacity>=8.0.0
 Requires-Dist: textual-dev>=1.7.0
+Requires-Dist: textual-serve>=0.1.0
 Requires-Dist: textual>=6.1.0
 Requires-Dist: tiktoken>=0.7.0
 Requires-Dist: tree-sitter-go>=0.23.0

{shotgun_sh-0.2.7.dev2 → shotgun_sh-0.2.8.dev1}/README.md

@@ -408,6 +408,82 @@ export SENTRY_DSN=your-sentry-dsn
 - **Opt-in for development**: Telemetry requires explicit environment variables
 - **Automatic in production**: Production builds include telemetry for error tracking
 
+## Docker
+
+Run Shotgun in a Docker container with web access.
+
+### Using Pre-built Images (Recommended)
+
+Pull the official image from GitHub Container Registry:
+
+```bash
+# Pull latest stable version
+docker pull ghcr.io/shotgun-sh/shotgun:latest
+
+# Or pull a specific version
+docker pull ghcr.io/shotgun-sh/shotgun:v0.1.0
+
+# Or pull development version
+docker pull ghcr.io/shotgun-sh/shotgun:dev
+```
+
+Then run:
+
+```bash
+docker run -p 8000:8000 \
+  -v $(pwd):/workspace \
+  -v ~/.shotgun-sh:/home/shotgun/.shotgun-sh \
+  ghcr.io/shotgun-sh/shotgun:latest --no-update-check
+```
+
+### Building from Source (Optional)
+
+If you prefer to build the image yourself:
+
+```bash
+docker build -t shotgun:latest .
+```
+
+### Run the Container
+
+The container requires two volume mounts:
+1. Your codebase/workspace directory (mounted to `/workspace`)
+2. Config directory for API keys and settings (mounted to `/home/shotgun/.shotgun-sh`)
+
+```bash
+# Basic usage (serves on port 8000)
+docker run -p 8000:8000 \
+  -v $(pwd):/workspace \
+  -v ~/.shotgun-sh:/home/shotgun/.shotgun-sh \
+  ghcr.io/shotgun-sh/shotgun:latest --no-update-check
+
+# Custom port
+docker run -p 3000:3000 \
+  -v $(pwd):/workspace \
+  -v ~/.shotgun-sh:/home/shotgun/.shotgun-sh \
+  ghcr.io/shotgun-sh/shotgun:latest --no-update-check --port 3000
+
+# Different codebase directory
+docker run -p 8000:8000 \
+  -v /path/to/your/project:/workspace \
+  -v ~/.shotgun-sh:/home/shotgun/.shotgun-sh \
+  ghcr.io/shotgun-sh/shotgun:latest --no-update-check
+
+# Run in background with auto-restart
+docker run -d --restart unless-stopped \
+  --name shotgun-web \
+  -p 8000:8000 \
+  -v $(pwd):/workspace \
+  -v ~/.shotgun-sh:/home/shotgun/.shotgun-sh \
+  ghcr.io/shotgun-sh/shotgun:latest --no-update-check
+```
+
+### Configuration
+
+On first run, configure your API keys through the web UI. The configuration will persist in the mounted `~/.shotgun-sh` directory.
+
+Access the web interface at `http://localhost:8000` (or your custom port).
+
 ## Support
 
 Join our discord https://discord.gg/5RmY6J2N7s

{shotgun_sh-0.2.7.dev2 → shotgun_sh-0.2.8.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shotgun-sh"
-version = "0.2.7.dev2"
+version = "0.2.8.dev1"
 description = "AI-powered research, planning, and task management CLI tool"
 readme = "README_PYPI.md"
 license = { text = "MIT" }
@@ -32,6 +32,7 @@ dependencies = [
     "posthog>=3.0.0",
     "textual>=6.1.0",
     "textual-dev>=1.7.0",
+    "textual-serve>=0.1.0",
     "kuzu>=0.7.0",
     "tree-sitter>=0.21.0",
     "tree-sitter-python>=0.23.0",

{shotgun_sh-0.2.7.dev2 → shotgun_sh-0.2.8.dev1}/src/shotgun/main.py

@@ -125,6 +125,34 @@ def main(
             help="Continue previous TUI conversation",
         ),
     ] = False,
+    web: Annotated[
+        bool,
+        typer.Option(
+            "--web",
+            help="Serve TUI as web application",
+        ),
+    ] = False,
+    port: Annotated[
+        int,
+        typer.Option(
+            "--port",
+            help="Port for web server (only used with --web)",
+        ),
+    ] = 8000,
+    host: Annotated[
+        str,
+        typer.Option(
+            "--host",
+            help="Host address for web server (only used with --web)",
+        ),
+    ] = "localhost",
+    public_url: Annotated[
+        str | None,
+        typer.Option(
+            "--public-url",
+            help="Public URL if behind proxy (only used with --web)",
+        ),
+    ] = None,
 ) -> None:
     """Shotgun - AI-powered CLI tool."""
     logger.debug("Starting shotgun CLI application")
@@ -134,16 +162,32 @@ def main(
         perform_auto_update_async(no_update_check=no_update_check)
 
     if ctx.invoked_subcommand is None and not ctx.resilient_parsing:
-        logger.debug("Launching shotgun TUI application")
-        try:
-            tui_app.run(
-                no_update_check=no_update_check, continue_session=continue_session
-            )
-        finally:
-            # Ensure PostHog is shut down cleanly even if TUI exits unexpectedly
-            from shotgun.posthog_telemetry import shutdown
-
-            shutdown()
+        if web:
+            logger.debug("Launching shotgun TUI as web application")
+            try:
+                tui_app.serve(
+                    host=host,
+                    port=port,
+                    public_url=public_url,
+                    no_update_check=no_update_check,
+                    continue_session=continue_session,
+                )
+            finally:
+                # Ensure PostHog is shut down cleanly even if server exits unexpectedly
+                from shotgun.posthog_telemetry import shutdown
+
+                shutdown()
+        else:
+            logger.debug("Launching shotgun TUI application")
+            try:
+                tui_app.run(
+                    no_update_check=no_update_check, continue_session=continue_session
+                )
+            finally:
+                # Ensure PostHog is shut down cleanly even if TUI exits unexpectedly
+                from shotgun.posthog_telemetry import shutdown
+
+                shutdown()
         raise typer.Exit()
 
     # For CLI commands, register PostHog shutdown handler

{shotgun_sh-0.2.7.dev2 → shotgun_sh-0.2.8.dev1}/src/shotgun/tui/app.py

@@ -152,5 +152,121 @@ def run(no_update_check: bool = False, continue_session: bool = False) -> None:
     app.run(inline_no_clear=True)
 
 
+def serve(
+    host: str = "localhost",
+    port: int = 8000,
+    public_url: str | None = None,
+    no_update_check: bool = False,
+    continue_session: bool = False,
+) -> None:
+    """Serve the TUI application as a web application.
+
+    Args:
+        host: Host address for the web server.
+        port: Port number for the web server.
+        public_url: Public URL if behind a proxy.
+        no_update_check: If True, disable automatic update checks.
+        continue_session: If True, continue from previous conversation.
+    """
+    # Clean up any corrupted databases BEFORE starting the TUI
+    # This prevents crashes from corrupted databases during initialization
+    import asyncio
+
+    from textual_serve.server import Server
+
+    from shotgun.codebase.core.manager import CodebaseGraphManager
+    from shotgun.utils import get_shotgun_home
+
+    storage_dir = get_shotgun_home() / "codebases"
+    manager = CodebaseGraphManager(storage_dir)
+
+    try:
+        removed = asyncio.run(manager.cleanup_corrupted_databases())
+        if removed:
+            logger.info(
+                f"Cleaned up {len(removed)} corrupted database(s) before TUI startup"
+            )
+    except Exception as e:
+        logger.error(f"Failed to cleanup corrupted databases: {e}")
+        # Continue anyway - the TUI can still function
+
+    # Create a new event loop after asyncio.run() closes the previous one
+    # This is needed for the Server.serve() method
+    loop = asyncio.new_event_loop()
+    asyncio.set_event_loop(loop)
+
+    # Build the command string based on flags
+    command = "shotgun"
+    if no_update_check:
+        command += " --no-update-check"
+    if continue_session:
+        command += " --continue"
+
+    # Create and start the server with hardcoded title and debug=False
+    server = Server(
+        command=command,
+        host=host,
+        port=port,
+        title="The Shotgun",
+        public_url=public_url,
+    )
+
+    # Set up graceful shutdown on SIGTERM/SIGINT
+    import signal
+    import sys
+
+    def signal_handler(_signum: int, _frame: Any) -> None:
+        """Handle shutdown signals gracefully."""
+        from shotgun.posthog_telemetry import shutdown
+
+        logger.info("Received shutdown signal, cleaning up...")
+        # Restore stdout/stderr before shutting down
+        sys.stdout = original_stdout
+        sys.stderr = original_stderr
+        shutdown()
+        sys.exit(0)
+
+    signal.signal(signal.SIGTERM, signal_handler)
+    signal.signal(signal.SIGINT, signal_handler)
+
+    # Suppress the textual-serve banner by redirecting stdout/stderr
+    import io
+
+    # Capture and suppress the banner, but show the actual serving URL
+    original_stdout = sys.stdout
+    original_stderr = sys.stderr
+
+    captured_output = io.StringIO()
+    sys.stdout = captured_output
+    sys.stderr = captured_output
+
+    try:
+        # This will print the banner to our captured output
+        import logging
+
+        # Temporarily set logging to ERROR level to suppress INFO messages
+        textual_serve_logger = logging.getLogger("textual_serve")
+        original_level = textual_serve_logger.level
+        textual_serve_logger.setLevel(logging.ERROR)
+
+        # Print our own message to the original stdout
+        sys.stdout = original_stdout
+        sys.stderr = original_stderr
+        print(f"Serving Shotgun TUI at http://{host}:{port}")
+        print("Press Ctrl+C to quit")
+
+        # Now suppress output again for the serve call
+        sys.stdout = captured_output
+        sys.stderr = captured_output
+
+        server.serve(debug=False)
+    finally:
+        # Restore original stdout/stderr
+        sys.stdout = original_stdout
+        sys.stderr = original_stderr
+        if "textual_serve_logger" in locals():
+            textual_serve_logger.setLevel(original_level)
+
+
 if __name__ == "__main__":
     run()