Metagit™

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:

1. At-a-glance view of a project's technical stacks, languages, external dependencies, and generated artifacts.
2. Switching between many Git projects during the day without losing context.
3. Isolating outside dependencies that weaken the security and dependability of your software delivery pipelines.
4. Automated documentation of a code's provenance.
5. 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.