git-juggler 0.2.6__tar.gz → 0.2.7__tar.gz

{git_juggler-0.2.6 → git_juggler-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: git-juggler
-Version: 0.2.6
+Version: 0.2.7
 Summary: A local Git dashboard for people juggling agents and too many repos.
 License-Expression: MIT
 License-File: LICENSE
@@ -21,6 +21,14 @@ Watch agents work live, follow every repo’s git graph, and catch what changed
 
 <img src="https://github.com/franz38/git-juggler/blob/main/resources/git-juggler-demo-4.png?raw=true" alt="git-juggler" width="100%">
 
+## What it does
+
+- Scans the immediate children of one or more configured folders for Git repos.
+- Lets you inspect and manage each repo's graph, branches, tags, stashes, dirty files, and file diffs.
+- Keeps a persistent terminal per open repo and runs Git actions there so you see the real commands and output.
+- Tracks local Claude Code and OpenCode sessions.
+- Connects GitHub Actions and Jenkins runs to commits and active pipelines.
+- VS Code-compatible themes.
 
 ## How to install
 
@@ -30,9 +38,17 @@ PATH in its own isolated environment, without touching your system Python:
 
 ```
 pipx install git-juggler
-git-juggler <path-to-scan>   # http://127.0.0.1:8000
+git-juggler [path-to-scan] [--host HOST] [--port PORT] [--no-open]
 ```
 
+`<path-to-scan>` is optional and defaults to the current directory. It is used
+to seed the initial search path; after that, search paths are managed in the app
+from the welcome wizard or Settings.
+
+- `--host HOST` changes the bind host from the default `127.0.0.1`.
+- `--port PORT` changes the backend port from the default `8000`.
+- `--no-open` disables opening the app in your browser automatically.
+
 If you don't have pipx yet:
 
 **macOS**
@@ -62,27 +78,44 @@ To upgrade later: `pipx upgrade git-juggler`.
 
 ## Dev mode
 
+Use the dev script to start both the backend and frontend dev servers:
+
+```
+./scripts/dev.sh [path-to-scan] [--port PORT] [--no-open]
+```
+
+- `path-to-scan` is optional. On first run, it seeds the folder whose immediate children are scanned for Git repos.
+- `--port PORT` is optional. It changes the backend port from the default `8000`; if you use it, update `src/frontend/vite.config.ts` locally so Vite proxies `/api` and `/ws` to the same port.
+- `--no-open` disables opening the app in your browser automatically.
+
+Or run them manually in two terminals:
+
 ```
 python3 -m venv .venv
 .venv/bin/pip install -e .
-.venv/bin/git-juggler <path-to-scan> --reload   # http://127.0.0.1:8000
+.venv/bin/git-juggler <path-to-scan> --reload [--no-open]
 ```
 
 ```
 cd src/frontend
 npm install
-npm run dev                                     # http://localhost:5173 (proxies /api and /ws)
+npm run dev                                     # http://localhost:5173 (proxies /api and /ws to :8000)
 ```
 
 Open http://localhost:5173.
 
+By default, `./scripts/dev.sh` opens http://localhost:5173 in your browser.
+
 ## Production (single port)
 
 ```
 cd src/frontend && npm install && npm run build
-cd ../.. && .venv/bin/git-juggler <path-to-scan>   # http://127.0.0.1:8000
+cd ../.. && .venv/bin/git-juggler <path-to-scan> [--no-open]
 ```
 
+The backend serves the built frontend in this mode, so only port 8000 is needed.
+By default, it opens the app in your browser.
+
 ## Build a Python package
 
 The Python wheel includes the built frontend assets. The generated assets are
@@ -100,8 +133,9 @@ The wheel and source distribution are written to `dist/`.
 Install the wheel locally with:
 
 ```
-pipx install dist/git_juggler-0.1.0-py3-none-any.whl --force
-git-juggler <path-to-scan>   # http://127.0.0.1:8000
+pipx install dist/git_juggler-*.whl --force
+git-juggler <path-to-scan> [--no-open]
 ```
 
-GitHub Actions runs the same build and uploads the distributions as artifacts.
+Versions are derived from Git tags. GitHub Actions runs the same build, uploads
+the distributions as artifacts, and publishes tagged releases to PyPI.

{git_juggler-0.2.6 → git_juggler-0.2.7}/README.md

@@ -8,6 +8,14 @@ Watch agents work live, follow every repo’s git graph, and catch what changed
 
 <img src="https://github.com/franz38/git-juggler/blob/main/resources/git-juggler-demo-4.png?raw=true" alt="git-juggler" width="100%">
 
+## What it does
+
+- Scans the immediate children of one or more configured folders for Git repos.
+- Lets you inspect and manage each repo's graph, branches, tags, stashes, dirty files, and file diffs.
+- Keeps a persistent terminal per open repo and runs Git actions there so you see the real commands and output.
+- Tracks local Claude Code and OpenCode sessions.
+- Connects GitHub Actions and Jenkins runs to commits and active pipelines.
+- VS Code-compatible themes.
 
 ## How to install
 
@@ -17,9 +25,17 @@ PATH in its own isolated environment, without touching your system Python:
 
 ```
 pipx install git-juggler
-git-juggler <path-to-scan>   # http://127.0.0.1:8000
+git-juggler [path-to-scan] [--host HOST] [--port PORT] [--no-open]
 ```
 
+`<path-to-scan>` is optional and defaults to the current directory. It is used
+to seed the initial search path; after that, search paths are managed in the app
+from the welcome wizard or Settings.
+
+- `--host HOST` changes the bind host from the default `127.0.0.1`.
+- `--port PORT` changes the backend port from the default `8000`.
+- `--no-open` disables opening the app in your browser automatically.
+
 If you don't have pipx yet:
 
 **macOS**
@@ -49,27 +65,44 @@ To upgrade later: `pipx upgrade git-juggler`.
 
 ## Dev mode
 
+Use the dev script to start both the backend and frontend dev servers:
+
+```
+./scripts/dev.sh [path-to-scan] [--port PORT] [--no-open]
+```
+
+- `path-to-scan` is optional. On first run, it seeds the folder whose immediate children are scanned for Git repos.
+- `--port PORT` is optional. It changes the backend port from the default `8000`; if you use it, update `src/frontend/vite.config.ts` locally so Vite proxies `/api` and `/ws` to the same port.
+- `--no-open` disables opening the app in your browser automatically.
+
+Or run them manually in two terminals:
+
 ```
 python3 -m venv .venv
 .venv/bin/pip install -e .
-.venv/bin/git-juggler <path-to-scan> --reload   # http://127.0.0.1:8000
+.venv/bin/git-juggler <path-to-scan> --reload [--no-open]
 ```
 
 ```
 cd src/frontend
 npm install
-npm run dev                                     # http://localhost:5173 (proxies /api and /ws)
+npm run dev                                     # http://localhost:5173 (proxies /api and /ws to :8000)
 ```
 
 Open http://localhost:5173.
 
+By default, `./scripts/dev.sh` opens http://localhost:5173 in your browser.
+
 ## Production (single port)
 
 ```
 cd src/frontend && npm install && npm run build
-cd ../.. && .venv/bin/git-juggler <path-to-scan>   # http://127.0.0.1:8000
+cd ../.. && .venv/bin/git-juggler <path-to-scan> [--no-open]
 ```
 
+The backend serves the built frontend in this mode, so only port 8000 is needed.
+By default, it opens the app in your browser.
+
 ## Build a Python package
 
 The Python wheel includes the built frontend assets. The generated assets are
@@ -87,8 +120,9 @@ The wheel and source distribution are written to `dist/`.
 Install the wheel locally with:
 
 ```
-pipx install dist/git_juggler-0.1.0-py3-none-any.whl --force
-git-juggler <path-to-scan>   # http://127.0.0.1:8000
+pipx install dist/git_juggler-*.whl --force
+git-juggler <path-to-scan> [--no-open]
 ```
 
-GitHub Actions runs the same build and uploads the distributions as artifacts.
+Versions are derived from Git tags. GitHub Actions runs the same build, uploads
+the distributions as artifacts, and publishes tagged releases to PyPI.

{git_juggler-0.2.6 → git_juggler-0.2.7}/scripts/dev.sh

@@ -5,14 +5,16 @@ set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 BACKEND_PORT=8000
+OPEN_BROWSER=1
 
 usage() {
-  echo "Usage: $0 [path-to-scan] [--port PORT]" >&2
+  echo "Usage: $0 [path-to-scan] [--port PORT] [--no-open]" >&2
   echo "  path-to-scan    optional: directory whose first-level children get scanned for git repos." >&2
   echo "                  Only used to seed the config on first run; scan paths are otherwise" >&2
   echo "                  managed in the app (welcome wizard / Settings)." >&2
   echo "  --port PORT     backend port (default: 8000). If you change this, also update" >&2
   echo "                  src/frontend/vite.config.ts's proxy target -- don't commit that change." >&2
+  echo "  --no-open       don't open the app in a browser automatically." >&2
 }
 
 SCAN_PATH=""
@@ -26,6 +28,10 @@ while [ $# -gt 0 ]; do
       BACKEND_PORT="${2:?--port requires a value}"
       shift 2
       ;;
+    --no-open)
+      OPEN_BROWSER=0
+      shift
+      ;;
     -*)
       echo "Unknown argument: $1" >&2
       usage
@@ -101,10 +107,10 @@ trap cleanup EXIT INT TERM
 
 if [ -n "$SCAN_PATH" ]; then
   echo "Starting backend (--reload) on port $BACKEND_PORT, scanning $SCAN_PATH ..."
-  "$GIT_JUGGLER" "$SCAN_PATH" --reload --port "$BACKEND_PORT" &
+  "$GIT_JUGGLER" "$SCAN_PATH" --reload --port "$BACKEND_PORT" --no-open &
 else
   echo "Starting backend (--reload) on port $BACKEND_PORT (scan paths from config) ..."
-  "$GIT_JUGGLER" --reload --port "$BACKEND_PORT" &
+  "$GIT_JUGGLER" --reload --port "$BACKEND_PORT" --no-open &
 fi
 BACKEND_PID=$!
 
@@ -112,6 +118,10 @@ echo "Starting frontend dev server..."
 (cd "$ROOT_DIR/src/frontend" && npm run dev) &
 FRONTEND_PID=$!
 
+if [ "$OPEN_BROWSER" = "1" ]; then
+  (sleep 1 && "$VENV_BIN/python" -m webbrowser http://localhost:5173) >/dev/null 2>&1 &
+fi
+
 echo ""
 echo "Backend:  http://127.0.0.1:$BACKEND_PORT"
 echo "Frontend: http://localhost:5173  <- open this"