ghosttrap-cli 0.3.0__tar.gz → 0.3.1__tar.gz

ghosttrap_cli-0.3.1/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: ghosttrap-cli
+Version: 0.3.1
+Summary: Watch for errors streaming from ghosttrap.io
+Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-cli
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: websockets>=12.0
+
+# ghosttrap-cli
+
+The developer-side listener for [ghosttrap](https://ghosttrap.io). Connects errors from remote servers to Claude Code in real time.
+
+Works with any Python app. Django and Celery get deep integration (middleware, app config, task failure hooks). Flask and other frameworks work via Python's logging and excepthook.
+
+## Setup
+
+Requires the [GitHub CLI](https://cli.github.com) (`gh`) and [Claude Code](https://claude.ai/code).
+
+```
+pip install ghosttrap-cli
+cd ~/your-project
+ghosttrap setup
+```
+
+Then in Claude Code:
+
+```
+/ghosttrap
+```
+
+That's it. `setup` authenticates via `gh`, claims the repo, and installs a Claude Code skill. The `/ghosttrap` skill handles everything else — it installs the SDK into your app, wires in the error hooks, and starts monitoring.
+
+## What happens next
+
+The skill file tells Claude Code to run `ghosttrap peek` in the background. Peek opens a WebSocket to ghosttrap.io and waits. When a production error arrives, Claude sees the full traceback — exception type, message, file, line, function — and starts fixing.
+
+After fixing, Claude restarts peek and waits for the next one. Errors become a real-time stream that your AI agent dispatches automatically.
+
+## The SDK
+
+Your app needs [ghosttrap-sdk](https://github.com/alex-rowley/ghosttrap-sdk) to report errors. The Claude Code skill handles the integration automatically — it installs the SDK, wires it into your app, and adds Django/Celery hooks if applicable. You shouldn't need to touch the SDK manually.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `ghosttrap setup` | Claim a repo, install the Claude Code skill |
+| `ghosttrap peek` | Wait for the next error, print it, exit |
+| `ghosttrap watch` | Stream all errors continuously |
+
+## How it works
+
+- **Setup** authenticates with GitHub to prove you own the repo, then saves a token locally
+- **Peek** and **watch** connect to ghosttrap.io using that token — no GitHub auth needed after setup
+- Errors that arrive while you're offline are replayed on next connect (cursor-based, no duplicates)
+- Local state is stored in `~/.ghosttrap/config.json`
+
+## Requirements
+
+- Python 3.10+
+- [GitHub CLI](https://cli.github.com) (`gh`) — used for authentication during setup
+- [Claude Code](https://claude.ai/code) — the AI agent that fixes your errors
+- macOS or Linux (Windows is untested)
+
+## Privacy
+
+Error data (tracebacks, exception messages, file paths) is routed through ghosttrap.io. The server is not open source yet — if there's demand for self-hosting, we'll open it up. Your GitHub token is used only during `setup` to verify repo ownership; it's never stored on the server. After setup, all communication uses a repo-specific token that grants access only to that repo's error stream — it cannot access your GitHub account.

ghosttrap_cli-0.3.1/README.md

@@ -0,0 +1,59 @@
+# ghosttrap-cli
+
+The developer-side listener for [ghosttrap](https://ghosttrap.io). Connects errors from remote servers to Claude Code in real time.
+
+Works with any Python app. Django and Celery get deep integration (middleware, app config, task failure hooks). Flask and other frameworks work via Python's logging and excepthook.
+
+## Setup
+
+Requires the [GitHub CLI](https://cli.github.com) (`gh`) and [Claude Code](https://claude.ai/code).
+
+```
+pip install ghosttrap-cli
+cd ~/your-project
+ghosttrap setup
+```
+
+Then in Claude Code:
+
+```
+/ghosttrap
+```
+
+That's it. `setup` authenticates via `gh`, claims the repo, and installs a Claude Code skill. The `/ghosttrap` skill handles everything else — it installs the SDK into your app, wires in the error hooks, and starts monitoring.
+
+## What happens next
+
+The skill file tells Claude Code to run `ghosttrap peek` in the background. Peek opens a WebSocket to ghosttrap.io and waits. When a production error arrives, Claude sees the full traceback — exception type, message, file, line, function — and starts fixing.
+
+After fixing, Claude restarts peek and waits for the next one. Errors become a real-time stream that your AI agent dispatches automatically.
+
+## The SDK
+
+Your app needs [ghosttrap-sdk](https://github.com/alex-rowley/ghosttrap-sdk) to report errors. The Claude Code skill handles the integration automatically — it installs the SDK, wires it into your app, and adds Django/Celery hooks if applicable. You shouldn't need to touch the SDK manually.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `ghosttrap setup` | Claim a repo, install the Claude Code skill |
+| `ghosttrap peek` | Wait for the next error, print it, exit |
+| `ghosttrap watch` | Stream all errors continuously |
+
+## How it works
+
+- **Setup** authenticates with GitHub to prove you own the repo, then saves a token locally
+- **Peek** and **watch** connect to ghosttrap.io using that token — no GitHub auth needed after setup
+- Errors that arrive while you're offline are replayed on next connect (cursor-based, no duplicates)
+- Local state is stored in `~/.ghosttrap/config.json`
+
+## Requirements
+
+- Python 3.10+
+- [GitHub CLI](https://cli.github.com) (`gh`) — used for authentication during setup
+- [Claude Code](https://claude.ai/code) — the AI agent that fixes your errors
+- macOS or Linux (Windows is untested)
+
+## Privacy
+
+Error data (tracebacks, exception messages, file paths) is routed through ghosttrap.io. The server is not open source yet — if there's demand for self-hosting, we'll open it up. Your GitHub token is used only during `setup` to verify repo ownership; it's never stored on the server. After setup, all communication uses a repo-specific token that grants access only to that repo's error stream — it cannot access your GitHub account.

{ghosttrap_cli-0.3.0 → ghosttrap_cli-0.3.1}/ghosttrap_cli/cli.py

@@ -6,15 +6,41 @@ import json
 import os
 import subprocess
 import sys
+import time
+import urllib.request
 
 import websockets
 
+__version__ = "0.3.0"
 
 GHOSTTRAP_SERVER = "wss://ghosttrap.io/stream/"
 CONFIG_DIR = os.path.expanduser("~/.ghosttrap")
 CONFIG_FILE = os.path.join(CONFIG_DIR, "config.json")
 SKILL_DIR = os.path.expanduser("~/.claude/skills/ghosttrap")
 SKILL_FILE = os.path.join(SKILL_DIR, "SKILL.md")
+GITHUB_CLI_RELEASES = "https://api.github.com/repos/alex-rowley/ghosttrap-cli/releases/latest"
+VERSION_CHECK_TTL = 86400  # check once per day
+
+
+def _check_cli_version(config):
+    """Check if a newer CLI version is available. Caches for 24h."""
+    last_check = config.get("cli_version_check", 0)
+    if time.time() - last_check < VERSION_CHECK_TTL:
+        return
+    try:
+        req = urllib.request.Request(GITHUB_CLI_RELEASES, headers={
+            "Accept": "application/vnd.github+json",
+            "User-Agent": "ghosttrap-cli",
+        })
+        with urllib.request.urlopen(req, timeout=3) as resp:
+            data = json.loads(resp.read())
+            latest = data.get("tag_name", "").lstrip("v")
+            if latest and latest != __version__:
+                print(f"ghosttrap-cli {latest} available (you have {__version__})", file=sys.stderr)
+    except Exception:
+        pass
+    config["cli_version_check"] = time.time()
+    _save_config(config)
 
 SKILL_CONTENT = """\
 ---
@@ -32,7 +58,7 @@ Read `~/.ghosttrap/config.json` for state. It contains:
 
 1. Detect the current repo from `git config --get remote.origin.url`.
 2. Look it up in the config. If the repo isn't there, tell the user to run `ghosttrap setup`.
-3. If `sdk_installed` is false or missing: install the SDK (`pip install git+https://github.com/arowley-predictive-power/ghosttrap-sdk.git`), wire `ghosttrap.init("<token>")` into the app startup. For Django projects, also add `"ghosttrap.django.GhostTrapApp"` to INSTALLED_APPS (re-attaches logging handler after Django's dictConfig) and `"ghosttrap.django.GhostTrapMiddleware"` to MIDDLEWARE (catches unhandled view exceptions). The SDK auto-hooks into Celery task_failure if Celery is installed, and attaches a logging handler for logger.exception() calls. Use whatever pattern the project already uses for configuration (env vars, settings files, hardcoded — match the existing style). Then update the config: set `sdk_installed: true`, `sdk_version`, `init_file` to record what you did.
+3. If `sdk_installed` is false or missing: install the SDK (`pip install ghosttrap-sdk`), wire `ghosttrap.init("<token>")` into the app startup. For Django projects, also add `"ghosttrap.django.GhostTrapApp"` to INSTALLED_APPS (re-attaches logging handler after Django's dictConfig) and `"ghosttrap.django.GhostTrapMiddleware"` to MIDDLEWARE (catches unhandled view exceptions). The SDK auto-hooks into Celery task_failure if Celery is installed, and attaches a logging handler for logger.exception() calls. Use whatever pattern the project already uses for configuration (env vars, settings files, hardcoded — match the existing style). Then update the config: set `sdk_installed: true`, `sdk_version`, `init_file` to record what you did.
 4. Run `ghosttrap peek` with `run_in_background: true`.
 
 ## When peek returns
@@ -114,7 +140,7 @@ def _print_setup_snippet(repo):
     token = repo["token"]
 
     print(f"\nadd to your app:\n", file=sys.stderr)
-    print(f"  pip install git+https://github.com/arowley-predictive-power/ghosttrap-sdk.git\n", file=sys.stderr)
+    print(f"  pip install ghosttrap-sdk\n", file=sys.stderr)
     print(f"  import ghosttrap\n", file=sys.stderr)
     print(f"  # option 1: token (recommended)", file=sys.stderr)
     print(f'  ghosttrap.init("{token}")\n', file=sys.stderr)
@@ -130,11 +156,13 @@ def get_gh_token():
         )
         token = result.stdout.strip()
         if result.returncode != 0 or not token:
-            print("error: could not get gh auth token. run 'gh auth login' first.", file=sys.stderr)
+            print("\nghosttrap uses your GitHub identity for authentication.", file=sys.stderr)
+            print("run 'gh auth login' to sign in, then try again.\n", file=sys.stderr)
             sys.exit(1)
         return token
     except FileNotFoundError:
-        print("error: gh cli not found. install it from https://cli.github.com", file=sys.stderr)
+        print("\nghosttrap requires the GitHub CLI for authentication.", file=sys.stderr)
+        print("install it from https://cli.github.com then try again.\n", file=sys.stderr)
         sys.exit(1)
 
 
@@ -173,6 +201,14 @@ async def _connect_and_handle(server_url, token, config, once=False):
                     if target:
                         _print_setup_snippet(target)
 
+                sdk_latest = event.get("sdk_latest")
+                if sdk_latest:
+                    cwd_repo = _detect_repo_from_cwd()
+                    if cwd_repo and cwd_repo in config.get("repos", {}):
+                        installed = config["repos"][cwd_repo].get("sdk_version")
+                        if installed and installed != sdk_latest:
+                            print(f"ghosttrap-sdk {sdk_latest} available (you have {installed})", file=sys.stderr)
+
                 if not once:
                     print(f"waiting for errors...", file=sys.stderr)
                 continue
@@ -266,6 +302,7 @@ async def watch(server_url, token):
 
 async def peek(server_url, token):
     config = _load_config()
+    _check_cli_version(config)
     await _connect_and_handle(server_url, token, config, once=True)
 
 

ghosttrap_cli-0.3.1/ghosttrap_cli.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: ghosttrap-cli
+Version: 0.3.1
+Summary: Watch for errors streaming from ghosttrap.io
+Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-cli
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: websockets>=12.0
+
+# ghosttrap-cli
+
+The developer-side listener for [ghosttrap](https://ghosttrap.io). Connects errors from remote servers to Claude Code in real time.
+
+Works with any Python app. Django and Celery get deep integration (middleware, app config, task failure hooks). Flask and other frameworks work via Python's logging and excepthook.
+
+## Setup
+
+Requires the [GitHub CLI](https://cli.github.com) (`gh`) and [Claude Code](https://claude.ai/code).
+
+```
+pip install ghosttrap-cli
+cd ~/your-project
+ghosttrap setup
+```
+
+Then in Claude Code:
+
+```
+/ghosttrap
+```
+
+That's it. `setup` authenticates via `gh`, claims the repo, and installs a Claude Code skill. The `/ghosttrap` skill handles everything else — it installs the SDK into your app, wires in the error hooks, and starts monitoring.
+
+## What happens next
+
+The skill file tells Claude Code to run `ghosttrap peek` in the background. Peek opens a WebSocket to ghosttrap.io and waits. When a production error arrives, Claude sees the full traceback — exception type, message, file, line, function — and starts fixing.
+
+After fixing, Claude restarts peek and waits for the next one. Errors become a real-time stream that your AI agent dispatches automatically.
+
+## The SDK
+
+Your app needs [ghosttrap-sdk](https://github.com/alex-rowley/ghosttrap-sdk) to report errors. The Claude Code skill handles the integration automatically — it installs the SDK, wires it into your app, and adds Django/Celery hooks if applicable. You shouldn't need to touch the SDK manually.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `ghosttrap setup` | Claim a repo, install the Claude Code skill |
+| `ghosttrap peek` | Wait for the next error, print it, exit |
+| `ghosttrap watch` | Stream all errors continuously |
+
+## How it works
+
+- **Setup** authenticates with GitHub to prove you own the repo, then saves a token locally
+- **Peek** and **watch** connect to ghosttrap.io using that token — no GitHub auth needed after setup
+- Errors that arrive while you're offline are replayed on next connect (cursor-based, no duplicates)
+- Local state is stored in `~/.ghosttrap/config.json`
+
+## Requirements
+
+- Python 3.10+
+- [GitHub CLI](https://cli.github.com) (`gh`) — used for authentication during setup
+- [Claude Code](https://claude.ai/code) — the AI agent that fixes your errors
+- macOS or Linux (Windows is untested)
+
+## Privacy
+
+Error data (tracebacks, exception messages, file paths) is routed through ghosttrap.io. The server is not open source yet — if there's demand for self-hosting, we'll open it up. Your GitHub token is used only during `setup` to verify repo ownership; it's never stored on the server. After setup, all communication uses a repo-specific token that grants access only to that repo's error stream — it cannot access your GitHub account.

{ghosttrap_cli-0.3.0 → ghosttrap_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ghosttrap-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "Watch for errors streaming from ghosttrap.io"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -16,7 +16,7 @@ dependencies = [
 ghosttrap = "ghosttrap_cli.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/arowley-predictive-power/ghosttrap-cli"
+Homepage = "https://github.com/alex-rowley/ghosttrap-cli"
 
 [tool.setuptools.packages.find]
 include = ["ghosttrap_cli*"]

ghosttrap_cli-0.3.0/PKG-INFO

@@ -1,32 +0,0 @@
-Metadata-Version: 2.4
-Name: ghosttrap-cli
-Version: 0.3.0
-Summary: Watch for errors streaming from ghosttrap.io
-Project-URL: Homepage, https://github.com/arowley-predictive-power/ghosttrap-cli
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: websockets>=12.0
-
-# ghosttrap-cli
-
-Watch for errors streaming from ghosttrap.io in real time.
-
-## Install
-
-```
-pip install ghosttrap-cli
-```
-
-Requires the [GitHub CLI](https://cli.github.com) (`gh`) for authentication.
-
-## Use
-
-```
-ghosttrap watch
-```
-
-Authenticates via your local `gh` session, subscribes to error streams
-for all repos you have access to, and prints events as they arrive.
-
-Human-readable summaries go to stderr. Machine-readable JSON goes to
-stdout, for piping into other tools.

ghosttrap_cli-0.3.0/README.md

@@ -1,23 +0,0 @@
-# ghosttrap-cli
-
-Watch for errors streaming from ghosttrap.io in real time.
-
-## Install
-
-```
-pip install ghosttrap-cli
-```
-
-Requires the [GitHub CLI](https://cli.github.com) (`gh`) for authentication.
-
-## Use
-
-```
-ghosttrap watch
-```
-
-Authenticates via your local `gh` session, subscribes to error streams
-for all repos you have access to, and prints events as they arrive.
-
-Human-readable summaries go to stderr. Machine-readable JSON goes to
-stdout, for piping into other tools.

ghosttrap_cli-0.3.0/ghosttrap_cli.egg-info/PKG-INFO

@@ -1,32 +0,0 @@
-Metadata-Version: 2.4
-Name: ghosttrap-cli
-Version: 0.3.0
-Summary: Watch for errors streaming from ghosttrap.io
-Project-URL: Homepage, https://github.com/arowley-predictive-power/ghosttrap-cli
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: websockets>=12.0
-
-# ghosttrap-cli
-
-Watch for errors streaming from ghosttrap.io in real time.
-
-## Install
-
-```
-pip install ghosttrap-cli
-```
-
-Requires the [GitHub CLI](https://cli.github.com) (`gh`) for authentication.
-
-## Use
-
-```
-ghosttrap watch
-```
-
-Authenticates via your local `gh` session, subscribes to error streams
-for all repos you have access to, and prints events as they arrive.
-
-Human-readable summaries go to stderr. Machine-readable JSON goes to
-stdout, for piping into other tools.