gitconductor

gitconductor is a command-line tool and Python library for managing git operations over nested GitLab groups using the official GitLab Python API. It traverses group and subgroup hierarchies, runs recursive git commands, and can work with Python packages inside a cloned hierarchy.

Full documentation: gitconductor.readthedocs.io.

Features

• Recursive group traversal across nested GitLab groups
• Git operations across many projects, such as clone, branch, checkout, add, commit, status, and push
• Hierarchy and access visualisation with Rich tables and trees
• Python package helpers for requirements, installation, and wheel building
• CLI and Python API entry points

Installation

pip install gitconductor

Configuration

Gitconductor needs a GitLab Personal Access Token. The quickest setup is:

export GITCONDUCTOR_GITLAB_API_KEY=<my-private-key>

Pass the full GitLab group or project URL to gitconductor clone. Gitconductor derives the GitLab instance from that URL.

Gitconductor can also store settings in a TOML file. By default, this is:

~/.config/gitconductor/gitconductor.toml

The location can be changed via GITCONDUCTOR_CONFIG or the top-level --cfg CLI option.

Quick Start

gitconductor clone https://gitlab.com/my-group
cd my-group
gitconductor status
gitconductor viz tree

Run commands from a subgroup or project directory to narrow the recursive scope. Use gitconductor clone --resume <url> to reuse an existing matching hierarchy.

Documentation

See the full documentation for:

• Configuration
• Git CLI commands
• Visualisation
• Python package commands
• Python API

Development & Contributing

Contributions are welcome. See CONTRIBUTING.md.

License

MIT License. See LICENCE.md.