Metagit™

Status: Stable Python 3.12+ Tests Build

Metagit gives you situational awareness across Git repositories. It helps multi-repo projects feel manageable, discoverable, and cohesive. It captures cross-repository relationships and project knowledge in easy to understand version controlled manifests.

About

This tool works well for scenarios like:

At-a-glance view of a project's technical stacks, languages, external dependencies, and generated artifacts.
Switching between many Git projects during the day without losing context.
Isolating outside dependencies that weaken the security and dependability of your software delivery pipelines.
Automated documentation of a code's provenance.
Helping new contributors get from onboarding to first commit faster.

Metagit is designed for developers, SREs, and AI agents who work across loosely connected repositories. It tracks the dependencies and project relationships that are easy to miss when you only look at one repo at a time.

Quick start

uv tool install -U metagit-cli
metagit version
metagit completion install --shell zsh   # optional tab completion

NOTE - Use the PyPI package name metagit-cli NOT metagit!

Inside any Git repository, initialize a metagit manifest:

metagit init

That creates .metagit.yml and updates or adds a .gitignore for .metagit/ (synced git repos).

Skills

Install bundled agent skills (OpenClaw, Hermes, Claude Code, and others):

metagit skills list
metagit skills install --scope user --target openclaw --target hermes

# or, using vercel's skills registry (preferred)
npx skills add metagit-ai/metagit-cli

Use --scope project when installing into a specific umbrella repository checkout. See Skills for targets, MCP install, and the project-management skill for agents.

Agent guides

Hermes agents and organization-wide IaC — illustrated workflow for using Metagit as a control plane across Terraform, policy, and module repositories (controller + subagents, layered agent_instructions, MCP tools).

Documentation

For installation guidance, detailed usage, including full CLI command surface, local MCP runtime setup, API-oriented flows, and advanced examples, use the documentation site:

Documentation

License

This project is licensed under the MIT License. See the LICENSE file for details.

Trademark

MetaGit™ is an open-source project.

MetaGit and the MetaGit logo are trademarks of Zachary Loeber.

Metadata

Release files for metagit-cli 0.36.0

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

Source distribution (sdist)

Source distribution for metagit-cli 0.36.0
File	Size	Uploaded
metagit_cli-0.36.0.tar.gz	5.3 MB	Oct 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for metagit-cli 0.36.0
File	Interpreter	ABI	Platform	Reset
metagit_cli-0.36.0-py3-none-any.whl 1.2 MB Oct 2, 2026	Python 3	none	any	Details

Total release size: 6.5 MB

Release files / metagit_cli-0.36.0.tar.gz

Download URL	metagit_cli-0.36.0.tar.gz
Size	5.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`ad61769d84d95d5c05d14beb6f0c69f373b896876e4b14fdbad9b5a24d284cef`
BLAKE2b-256 checksum How to use checksums	`e4c22e0900d032a3a723eb3c93e5706b7df7af50e460d7d36196fa308ce44ab5`
Upload date	Oct 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

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/metagit-ai/metagit-cli
Publishing commit: github.com/metagit-ai/metagit-cli/tree/d5cd383d11d0beb4c33f5d13f9b53adb496259c5

Workflow

Publishing configuration: github.com/metagit-ai/metagit-cli/blob/d5cd383d11d0beb4c33f5d13f9b53adb496259c5/.github/workflows/release.yaml
Publishing logs: github.com/metagit-ai/metagit-cli/actions/runs/37037294284/attempts/1

Artifact

Subject: metagit_cli-0.36.0.tar.gz
SHA-256 checksum: ad61769d84d95d5c05d14beb6f0c69f373b896876e4b14fdbad9b5a24d284cef Verifying attestations

Release files / metagit_cli-0.36.0-py3-none-any.whl

Download URL	metagit_cli-0.36.0-py3-none-any.whl
Size	1.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`44db98eca5067b379357160fca5456835c42f7bac1340ef7b4449b848cff4670`
BLAKE2b-256 checksum How to use checksums	`4722d1e938e3e0c1a2faaf30410dc1a8cde842edb3f772e8ef51411ca24e386f`
Upload date	Oct 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/metagit-ai/metagit-cli
Publishing commit: github.com/metagit-ai/metagit-cli/tree/d5cd383d11d0beb4c33f5d13f9b53adb496259c5

Workflow

Publishing configuration: github.com/metagit-ai/metagit-cli/blob/d5cd383d11d0beb4c33f5d13f9b53adb496259c5/.github/workflows/release.yaml
Publishing logs: github.com/metagit-ai/metagit-cli/actions/runs/37037294284/attempts/1

Artifact

Subject: metagit_cli-0.36.0-py3-none-any.whl
SHA-256 checksum: 44db98eca5067b379357160fca5456835c42f7bac1340ef7b4449b848cff4670 Verifying attestations