Skip to content

repository-manager

Manage your git projects across a workspace — a CLI, API, MCP server, and A2A agent for bulk Git operations, phased multi-repository releases, and cross-repository graph intelligence in the agent-utilities ecosystem.

Official documentation

This site is the canonical reference for repository-manager, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

repository-manager operates a whole workspace of Git repositories as one unit. It wraps bulk Git operations — clone, pull, push — with typed, deterministic interfaces, and adds an autonomous release harness for phased, dependency-ordered version bumps and pushes across the ecosystem. It provides:

  • Git — a workspace-aware client (repository_manager.repository_manager) for cloning, pulling, branch enumeration, validation, and phased maintenance.
  • Action-routed MCP tools — consolidated, togglable tool modules (git_operations, workspace_management, project_management, misc) that keep the LLM context small while exposing the full surface.
  • A cross-repository graph engine — NetworkX in-memory analytics with LadybugDB Cypher persistence for impact, path, and dependency queries across the workspace.
  • An integrated Pydantic-AI graph agent — orchestrating specialists over the Agent Control Protocol (ACP) and the Agent Web UI (AG-UI).

Explore the documentation

  • Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
  • Usage — the MCP tools, the Git Python client, and the CLI.
  • Overview — ecosystem role, enterprise readiness, and architecture.
  • Phased Maintenance — dependency-ordered workspace updates.
  • Phased Push — parallel, phase-gated multi-repository releases.
  • Concepts — the CONCEPT:RM-* registry.

Quick start

pip install "repository-manager[mcp]"
repository-manager-mcp            # stdio MCP server (default transport)

Point it at a workspace of Git repositories:

export REPOSITORY_MANAGER_WORKSPACE=/home/apps/workspace
repository-manager-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, DNS).