augint-mono

CLI tools for coordinating monorepos with git submodules.

Installation

uv add --dev augint-mono

Usage

ai-mono status              # Cross-repo status dashboard
ai-mono sync [--commit]     # Sync submodule pointers to latest
ai-mono init                # First-time submodule setup
ai-mono health              # Cross-repo health analysis
ai-mono foreach <cmd>       # Run shell command in each submodule

Limitations

ai-mono foreach runs shell commands only. AI agent skills (invoked as /skill-name in agent UIs) are handled by the AI agent, not by the shell, so they cannot be delegated through foreach. To run a skill across submodules, the AI agent must iterate over them itself -- this is what the ai-mono-foreach skill in augint-shell does.

Submodule Branch Tracking

Each submodule should have a branch configured in .gitmodules so that ai-mono sync knows which branch to track:

# IaC repos (dev-to-main workflow) should track dev
git config -f .gitmodules submodule.backend.branch dev

# Library repos (main-only) should track main
git config -f .gitmodules submodule.shared-lib.branch main