https://github.com/metagit-ai/metagit-cli
Situational awareness across Git repositories.
https://github.com/metagit-ai/metagit-cli
agent-skills cli git mcp-server metadata project-management python situational-awareness skill
Last synced: 3 days ago
JSON representation
Situational awareness across Git repositories.
- Host: GitHub
- URL: https://github.com/metagit-ai/metagit-cli
- Owner: metagit-ai
- License: mit
- Created: 2025-06-05T21:16:04.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-23T20:10:25.000Z (6 days ago)
- Last Synced: 2026-06-23T22:11:45.612Z (6 days ago)
- Topics: agent-skills, cli, git, mcp-server, metadata, project-management, python, situational-awareness, skill
- Language: Python
- Homepage: https://metagit-ai.github.io/metagit-cli/
- Size: 6.44 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 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
```bash
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:
```bash
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):
```bash
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](docs/skills.md) for targets, MCP install, and the project-management skill for agents.
## Agent guides
- [Hermes agents and organization-wide IaC](docs/hermes-iac-workspace-guide.md) — 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](https://metagit-ai.github.io/metagit-cli/)
## License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE.md) file for details.
## Trademark
MetaGit™ is an open-source project.
MetaGit and the MetaGit logo are trademarks of Zachary Loeber.