shotgun-sh 0.2.9.dev1__tar.gz → 0.2.10__tar.gz

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shotgun-sh
-Version: 0.2.9.dev1
+Version: 0.2.10
 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
@@ -26,7 +26,7 @@ Requires-Dist: genai-prices>=0.0.27
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: kuzu>=0.7.0
-Requires-Dist: logfire[pydantic-ai]>=2.0.0
+Requires-Dist: logfire>=2.0.0
 Requires-Dist: openai>=1.0.0
 Requires-Dist: packaging>=23.0
 Requires-Dist: posthog>=3.0.0
@@ -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
@@ -83,13 +84,30 @@ Every research finding, every architectural decision, every "here's why we didn'
 
 ## Installation
 
-### Using pipx (Recommended)
+### Using uvx (Recommended)
+
+**Quick start (ephemeral):**
+```bash
+uvx shotgun-sh
+```
+
+**Install permanently:**
+```bash
+uv tool install shotgun-sh
+```
+
+**Why uvx?** It's 10-100x faster than pipx and handles binary wheels more reliably. If you don't have `uv` installed, get it at [astral.sh/uv](https://astral.sh/uv) or `curl -LsSf https://astral.sh/uv/install.sh | sh`
+
+### Using pipx
 
 ```bash
 pipx install shotgun-sh
 ```
 
-**Why pipx?** It installs Shotgun in an isolated environment, preventing dependency conflicts with your other Python projects.
+If you encounter build errors with kuzu on macOS:
+```bash
+pipx install --pip-args="--only-binary kuzu" shotgun-sh
+```
 
 ### Using pip
 

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/README.md

@@ -10,7 +10,35 @@ A Python CLI tool for research, planning, and task management powered by AI agen
 
 ## Installation
 
-### From PyPI (Recommended)
+### Using uvx (Recommended)
+
+**Quick start (ephemeral):**
+```bash
+uvx shotgun-sh
+```
+
+**Install permanently:**
+```bash
+uv tool install shotgun-sh
+```
+
+**Why uvx?** It's 10-100x faster than pipx and handles binary wheels more reliably. If you don't have `uv` installed, get it at [astral.sh/uv](https://astral.sh/uv) or:
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### Using pipx
+
+```bash
+pipx install shotgun-sh
+```
+
+If you encounter build errors with kuzu on macOS:
+```bash
+pipx install --pip-args="--only-binary kuzu" shotgun-sh
+```
+
+### Using pip
 
 ```bash
 pip install shotgun-sh
@@ -115,6 +143,8 @@ shotgun --no-update-check research "topic"
 ### Installation Methods
 
 The update command automatically detects and uses the appropriate method:
+- **uvx**: Run `uvx shotgun-sh` again or use `uv tool install shotgun-sh` for permanent installation
+- **uv tool**: `uv tool upgrade shotgun-sh`
 - **pipx**: `pipx upgrade shotgun-sh`
 - **pip**: `pip install --upgrade shotgun-sh`
 - **venv**: Updates within the virtual environment
@@ -408,6 +438,90 @@ 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
+```
+
+**Note:** The Docker image automatically includes `--force-reindex` to ensure fresh indexing on startup. You don't need to add any additional flags.
+
+### 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
+```
+
+**All Docker commands automatically include `--force-reindex`** - you don't need to specify it. The flag is baked into the Docker image's ENTRYPOINT to ensure reliable codebase indexing in containerized environments.
+
+### 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).
+
+### Codebase Indexing in Docker
+
+The Docker image automatically prompts you to index the codebase on each startup. This ensures you're always working with up-to-date code analysis, even if the container restarts or you mount a different directory. Simply click "Index now" when prompted.
+
 ## Support
 
 Join our discord https://discord.gg/5RmY6J2N7s

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/README_PYPI.md

@@ -28,13 +28,30 @@ Every research finding, every architectural decision, every "here's why we didn'
 
 ## Installation
 
-### Using pipx (Recommended)
+### Using uvx (Recommended)
+
+**Quick start (ephemeral):**
+```bash
+uvx shotgun-sh
+```
+
+**Install permanently:**
+```bash
+uv tool install shotgun-sh
+```
+
+**Why uvx?** It's 10-100x faster than pipx and handles binary wheels more reliably. If you don't have `uv` installed, get it at [astral.sh/uv](https://astral.sh/uv) or `curl -LsSf https://astral.sh/uv/install.sh | sh`
+
+### Using pipx
 
 ```bash
 pipx install shotgun-sh
 ```
 
-**Why pipx?** It installs Shotgun in an isolated environment, preventing dependency conflicts with your other Python projects.
+If you encounter build errors with kuzu on macOS:
+```bash
+pipx install --pip-args="--only-binary kuzu" shotgun-sh
+```
 
 ### Using pip
 

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shotgun-sh"
-version = "0.2.9.dev1"
+version = "0.2.10"
 description = "AI-powered research, planning, and task management CLI tool"
 readme = "README_PYPI.md"
 license = { text = "MIT" }
@@ -27,11 +27,12 @@ dependencies = [
     "pydantic-ai>=0.0.14",
     "httpx>=0.27.0",
     "jinja2>=3.1.0",
-    "logfire[pydantic-ai]>=2.0.0",
+    "logfire>=2.0.0",
     "sentry-sdk[pure_eval]>=2.0.0",
     "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",
@@ -65,6 +66,7 @@ dev = [
 
 [project.scripts]
 shotgun = "shotgun.main:app"
+shotgun-sh = "shotgun.main:app"
 
 [build-system]
 requires = ["hatchling"]
@@ -162,3 +164,6 @@ exclude_lines = [
 precision = 2
 skip_covered = false
 show_missing = true
+
+[tool.uv.pip]
+only-binary = ["kuzu"]

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/agents/config/manager.py

@@ -142,7 +142,7 @@ class ConfigManager:
                             # Find default model for this provider
                             provider_models = {
                                 ProviderType.OPENAI: ModelName.GPT_5,
-                                ProviderType.ANTHROPIC: ModelName.CLAUDE_SONNET_4_5,
+                                ProviderType.ANTHROPIC: ModelName.CLAUDE_HAIKU_4_5,
                                 ProviderType.GOOGLE: ModelName.GEMINI_2_5_PRO,
                             }
 
@@ -243,7 +243,7 @@ class ConfigManager:
 
                 provider_models = {
                     ProviderType.OPENAI: ModelName.GPT_5,
-                    ProviderType.ANTHROPIC: ModelName.CLAUDE_SONNET_4_5,
+                    ProviderType.ANTHROPIC: ModelName.CLAUDE_HAIKU_4_5,
                     ProviderType.GOOGLE: ModelName.GEMINI_2_5_PRO,
                 }
                 if provider_enum in provider_models:

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/agents/config/models.py

@@ -28,6 +28,7 @@ class ModelName(StrEnum):
     GPT_5_MINI = "gpt-5-mini"
     CLAUDE_OPUS_4_1 = "claude-opus-4-1"
     CLAUDE_SONNET_4_5 = "claude-sonnet-4-5"
+    CLAUDE_HAIKU_4_5 = "claude-haiku-4-5"
     GEMINI_2_5_PRO = "gemini-2.5-pro"
     GEMINI_2_5_FLASH = "gemini-2.5-flash"
 
@@ -110,6 +111,13 @@ MODEL_SPECS: dict[ModelName, ModelSpec] = {
         max_output_tokens=16_000,
         litellm_proxy_model_name="anthropic/claude-sonnet-4-5",
     ),
+    ModelName.CLAUDE_HAIKU_4_5: ModelSpec(
+        name=ModelName.CLAUDE_HAIKU_4_5,
+        provider=ProviderType.ANTHROPIC,
+        max_input_tokens=200_000,
+        max_output_tokens=64_000,
+        litellm_proxy_model_name="anthropic/claude-haiku-4-5",
+    ),
     ModelName.GEMINI_2_5_PRO: ModelSpec(
         name=ModelName.GEMINI_2_5_PRO,
         provider=ProviderType.GOOGLE,

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/agents/config/provider.py

@@ -32,6 +32,34 @@ logger = get_logger(__name__)
 _model_cache: dict[tuple[ProviderType, KeyProvider, ModelName, str], Model] = {}
 
 
+def get_default_model_for_provider(config: ShotgunConfig) -> ModelName:
+    """Get the default model based on which provider/account is configured.
+
+    Checks API keys in priority order and returns appropriate default model.
+    Treats Shotgun Account as a provider context.
+
+    Args:
+        config: Shotgun configuration containing API keys
+
+    Returns:
+        Default ModelName for the configured provider/account
+    """
+    # Priority 1: Shotgun Account
+    if _get_api_key(config.shotgun.api_key):
+        return ModelName.CLAUDE_HAIKU_4_5
+
+    # Priority 2: Individual provider keys
+    if _get_api_key(config.anthropic.api_key):
+        return ModelName.CLAUDE_HAIKU_4_5
+    if _get_api_key(config.openai.api_key):
+        return ModelName.GPT_5
+    if _get_api_key(config.google.api_key):
+        return ModelName.GEMINI_2_5_PRO
+
+    # Fallback: system-wide default
+    return ModelName.CLAUDE_HAIKU_4_5
+
+
 def get_or_create_model(
     provider: ProviderType,
     key_provider: "KeyProvider",
@@ -172,7 +200,7 @@ def get_provider_model(
             model_name = provider_or_model
         else:
             # No specific model requested - use selected or default
-            model_name = config.selected_model or ModelName.CLAUDE_SONNET_4_5
+            model_name = config.selected_model or ModelName.CLAUDE_HAIKU_4_5
 
         if model_name not in MODEL_SPECS:
             raise ValueError(f"Model '{model_name.value}' not found")
@@ -247,8 +275,8 @@ def get_provider_model(
         if not api_key:
             raise ValueError("Anthropic API key not configured. Set via config.")
 
-        # Use requested model or default to claude-sonnet-4-5
-        model_name = requested_model if requested_model else ModelName.CLAUDE_SONNET_4_5
+        # Use requested model or default to claude-haiku-4-5
+        model_name = requested_model if requested_model else ModelName.CLAUDE_HAIKU_4_5
         if model_name not in MODEL_SPECS:
             raise ValueError(f"Model '{model_name.value}' not found")
         spec = MODEL_SPECS[model_name]

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/api_endpoints.py

@@ -1,10 +1,16 @@
 """Shotgun backend service API endpoints and URLs."""
 
+import os
+
 # Shotgun Web API base URL (for authentication/subscription)
 # Can be overridden with environment variable
-SHOTGUN_WEB_BASE_URL = "https://api-219702594231.us-east4.run.app"
+SHOTGUN_WEB_BASE_URL = os.getenv(
+    "SHOTGUN_WEB_BASE_URL", "https://api-219702594231.us-east4.run.app"
+)
 # Shotgun's LiteLLM proxy base URL (for AI model requests)
-LITELLM_PROXY_BASE_URL = "https://litellm-219702594231.us-east4.run.app"
+LITELLM_PROXY_BASE_URL = os.getenv(
+    "SHOTGUN_ACCOUNT_LLM_BASE_URL", "https://litellm-219702594231.us-east4.run.app"
+)
 
 # Provider-specific LiteLLM proxy endpoints
 LITELLM_PROXY_ANTHROPIC_BASE = f"{LITELLM_PROXY_BASE_URL}/anthropic"

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/build_constants.py

@@ -12,8 +12,8 @@ POSTHOG_API_KEY = ''
 POSTHOG_PROJECT_ID = '191396'
 
 # Logfire configuration embedded at build time (only for dev builds)
-LOGFIRE_ENABLED = 'true'
-LOGFIRE_TOKEN = 'pylf_v1_us_KZ5NM1pP3NwgJkbBJt6Ftdzk8mMhmrXcGJHQQgDJ1LfK'
+LOGFIRE_ENABLED = ''
+LOGFIRE_TOKEN = ''
 
 # Build metadata
 BUILD_TIME_ENV = "production" if SENTRY_DSN else "development"

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/cli/update.py

@@ -45,7 +45,7 @@ def update(
 
     This command will:
     - Check PyPI for the latest version
-    - Detect your installation method (pipx, pip, or venv)
+    - Detect your installation method (uvx, uv-tool, pipx, pip, or venv)
     - Perform the appropriate upgrade command
 
     Examples:
@@ -93,6 +93,8 @@ def update(
         )
         console.print(
             "Use --force to update anyway, or install the stable version with:\n"
+            "  uv tool install shotgun-sh\n"
+            "  or\n"
             "  pipx install shotgun-sh\n"
             "  or\n"
             "  pip install shotgun-sh",
@@ -134,7 +136,19 @@ def update(
             console.print(f"\n[red]✗[/red] {message}", style="bold red")
 
             # Provide manual update instructions
-            if method == "pipx":
+            if method == "uvx":
+                console.print(
+                    "\n[yellow]Run uvx again to use the latest version:[/yellow]\n"
+                    "  uvx shotgun-sh\n"
+                    "\n[yellow]Or install permanently:[/yellow]\n"
+                    "  uv tool install shotgun-sh"
+                )
+            elif method == "uv-tool":
+                console.print(
+                    "\n[yellow]Try updating manually:[/yellow]\n"
+                    "  uv tool upgrade shotgun-sh"
+                )
+            elif method == "pipx":
                 console.print(
                     "\n[yellow]Try updating manually:[/yellow]\n"
                     "  pipx upgrade shotgun-sh"

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/codebase/core/manager.py

@@ -371,7 +371,16 @@ class CodebaseGraphManager:
                 )
                 import shutil
 
-                shutil.rmtree(graph_path)
+                # Handle both files and directories (kuzu v0.11.2+ uses files)
+                if graph_path.is_file():
+                    graph_path.unlink()  # Delete file
+                    # Also delete WAL file if it exists
+                    wal_path = graph_path.with_suffix(graph_path.suffix + ".wal")
+                    if wal_path.exists():
+                        wal_path.unlink()
+                        logger.debug(f"Deleted WAL file: {wal_path}")
+                else:
+                    shutil.rmtree(graph_path)  # Delete directory
 
         # Import the builder from local core module
         from shotgun.codebase.core import CodebaseIngestor

{shotgun_sh-0.2.9.dev1 → shotgun_sh-0.2.10}/src/shotgun/main.py

@@ -125,6 +125,41 @@ 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,
+    force_reindex: Annotated[
+        bool,
+        typer.Option(
+            "--force-reindex",
+            help="Force re-indexing of codebase (ignores existing index)",
+        ),
+    ] = False,
 ) -> None:
     """Shotgun - AI-powered CLI tool."""
     logger.debug("Starting shotgun CLI application")
@@ -134,16 +169,35 @@ 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,
+                    force_reindex=force_reindex,
+                )
+            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,
+                    force_reindex=force_reindex,
+                )
+            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