gix

Manage multiple git sub-repos without constantly cd-ing into their folder first.

Installation

Requires Python 3.12+.

pip install --upgrade gix-cli
gix --install-completion

Check your installed version:

gix --version

Getting started

Run this once in the parent directory that holds your sub-repos:

gix init

This creates a gix.toml file in the current folder, which is where all your registered aliases will be stored.

If you already have git repos sitting in subfolders and want to register them all at once:

gix init --fetch

To wipe an existing gix.toml and start over:

gix init --overwrite

Managing aliases

Add the repo in your current working directory as an alias:

cd path/to/some-repo
gix alias add backend

List all registered aliases:

gix alias list

Rename an alias:

gix alias rename backend api

Remove an alias (this only removes it from gix.toml, the repo itself is untouched):

gix alias delete api

Running git commands

Once a repo is registered under an alias, run any git command against it from anywhere inside the parent tree:

gix backend status
gix backend pull
gix backend log -5

gix looks up the alias, finds the matching repo path, and runs git <your arguments> there

How it works

result = subprocess.run(["git", *git_args], cwd=engine.read()["repos"].get(alias))

Notes

gix doesn't do anything to your actual git repos. Tt only manages the alias-to-path mapping.
If gix.toml gets deleted or corrupted, just run gix init again.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gix_cli-2.0.0.tar.gz (6.4 kB view details)

Uploaded Aug 10, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gix_cli-2.0.0-py3-none-any.whl (8.6 kB view details)

Uploaded Aug 10, 2026 Python 3

File details

Details for the file gix_cli-2.0.0.tar.gz.

File metadata

Download URL: gix_cli-2.0.0.tar.gz
Upload date: Aug 10, 2026
Size: 6.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gix_cli-2.0.0.tar.gz
Algorithm	Hash digest
SHA256	`db63adefecf01f57c4068c5b124bfb69800fb4a0b2b3f43e49c957900e349820`
MD5	`cd9c2df1fd09d282d5b9195e4cf45e15`
BLAKE2b-256	`5025a57bf2bcd7ab6232cc07b0241783588b4c09eccbbee3275946a9e3e05114`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gix_cli-2.0.0.tar.gz:

Publisher: release.yml on DevTool-Superset/gix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gix_cli-2.0.0.tar.gz
- Subject digest: db63adefecf01f57c4068c5b124bfb69800fb4a0b2b3f43e49c957900e349820
- Sigstore transparency entry: 2411399166
- Sigstore integration time: Aug 10, 2026
Source repository:
- Permalink: DevTool-Superset/gix@4b7fcee2f4801b5342720303cdbe7ea9d77ab884
- Branch / Tag: refs/heads/master
- Owner: https://github.com/DevTool-Superset
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@4b7fcee2f4801b5342720303cdbe7ea9d77ab884
- Trigger Event: push