cal-gitlab-mirror 1.1.0b1

A tool to mirror GitLab repositories between two GitLab instances

cal-gitlab-mirror

A tool to mirror GitLab repositories between two GitLab instances.

Installation

pip install cal-gitlab-mirror

Or run directly with uv:

uvx cal-gitlab-mirror --help

Quick Start

# Mirror from source GitLab
cal-gitlab-mirror pull \
  --source-url https://gitlab.com \
  --source-token $SOURCE_TOKEN \
  --source-group myorg \
  --output-dir ./mirror

# Push to destination GitLab
cal-gitlab-mirror push \
  --dest-url https://gitlab.internal.com \
  --dest-token $DEST_TOKEN \
  --dest-group mirror/myorg \
  --input-dir ./mirror

Documentation

See the full documentation for detailed usage and configuration options.

Development

# Set up development environment
make dev

# Run linting and type checking
make check

# Auto-format code
make format

# Build wheel and docs
make build

Publishing

Publishing requires cal-publish-python configuration. See the cal-publish-python documentation for setup.

# Build first
make build

# Publish wheel to PyPI and docs to GitLab Pages
make publish

Licence

MIT License — Copyright 2026 Cyber Assessment Labs