git-juggler

A local Git dashboard for people juggling agents and too many repos.

git-juggler is a local dashboard for agent-heavy workflows and multi-repo projects. Watch agents work live, follow every repo’s git graph, and see what changed across your workspace without opening a dozen editors.

How to install

git-juggler is published on PyPI. The recommended way to install it is with pipx, which puts the git-juggler command on your 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

If you don't have pipx yet:

macOS

brew install pipx
pipx ensurepath

Linux

sudo apt install pipx   # Debian/Ubuntu
sudo dnf install pipx   # Fedora
pipx ensurepath

Many recent distros (like macOS with Homebrew) block a plain global pip install outside a virtual environment (PEP 668); pipx is the supported way around that.

Windows

py -m pip install --user pipx
py -m pipx ensurepath

Restart your terminal after ensurepath so the updated PATH takes effect. To upgrade later: pipx upgrade git-juggler.

Dev mode

python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/git-juggler <path-to-scan> --reload   # http://127.0.0.1:8000

cd src/frontend
npm install
npm run dev                                     # http://localhost:5173 (proxies /api and /ws)

Open http://localhost:5173.

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

Build a Python package

The Python wheel includes the built frontend assets. The generated assets are not committed; scripts/build-package.sh builds them and copies them into the backend package before creating the distributions.

python3 -m venv .venv
.venv/bin/pip install build
./scripts/build-package.sh

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

GitHub Actions runs the same build and uploads the distributions as artifacts.

Metadata

Release files for git-juggler 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for git-juggler 0.2.2
File	Size	Uploaded
git_juggler-0.2.2.tar.gz	552.8 kB	Sep 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for git-juggler 0.2.2
File	Interpreter	ABI	Platform	Reset
git_juggler-0.2.2-py3-none-any.whl 305.4 kB Sep 26, 2026	Python 3	none	any	Details

Total release size: 858.2 kB

Release files / git_juggler-0.2.2.tar.gz

Download URL	git_juggler-0.2.2.tar.gz
Size	552.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`cb009a1b1ca17b1ce09b7666d9eb8feda82c05475003d94012344fb65565a7ff`
BLAKE2b-256 checksum How to use checksums	`3acb2bc7d64c655417d1da74fc41f79879f290b166766847aee3d4560f4d5e33`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/franz38/git-juggler
Publishing commit: github.com/franz38/git-juggler/tree/d5899500853c2cc0ce7bca072019cf7756759212

Workflow

Publishing configuration: github.com/franz38/git-juggler/blob/d5899500853c2cc0ce7bca072019cf7756759212/.github/workflows/build-package.yml
Publishing logs: github.com/franz38/git-juggler/actions/runs/36252579335/attempts/1

Artifact

Subject: git_juggler-0.2.2.tar.gz
SHA-256 checksum: cb009a1b1ca17b1ce09b7666d9eb8feda82c05475003d94012344fb65565a7ff Verifying attestations

Release files / git_juggler-0.2.2-py3-none-any.whl

Download URL	git_juggler-0.2.2-py3-none-any.whl
Size	305.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`96aa577ea144e299ed3109a3c61775d65849ea681796cf7896b679aaca9d00c3`
BLAKE2b-256 checksum How to use checksums	`2889b830e941ca55b134b49cec040041bf12b300ce8c9ddaa0b234cd1d1ebd19`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/franz38/git-juggler
Publishing commit: github.com/franz38/git-juggler/tree/d5899500853c2cc0ce7bca072019cf7756759212

Workflow

Publishing configuration: github.com/franz38/git-juggler/blob/d5899500853c2cc0ce7bca072019cf7756759212/.github/workflows/build-package.yml
Publishing logs: github.com/franz38/git-juggler/actions/runs/36252579335/attempts/1

Artifact

Subject: git_juggler-0.2.2-py3-none-any.whl
SHA-256 checksum: 96aa577ea144e299ed3109a3c61775d65849ea681796cf7896b679aaca9d00c3 Verifying attestations