Metadata-Version: 2.3
Name: augint-mono
Version: 0.1.4
Summary: CLI tools for coordinating monorepos with git submodules
Author: svange
Requires-Dist: click>=8.1.0
Requires-Dist: rich>=14.0
Requires-Dist: pytest>=7.4.0 ; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0 ; extra == 'dev'
Requires-Dist: ruff>=0.8.0 ; extra == 'dev'
Requires-Dist: mypy>=1.8.0 ; extra == 'dev'
Requires-Dist: python-semantic-release>=10.3.1 ; extra == 'dev'
Requires-Dist: pre-commit>=4.0.0 ; extra == 'dev'
Requires-Dist: bandit>=1.7.0 ; extra == 'dev'
Requires-Dist: pip-audit>=2.7.0 ; extra == 'dev'
Requires-Dist: pip-licenses>=5.0.0 ; extra == 'dev'
Requires-Dist: pytest-html>=4.0.0 ; extra == 'dev'
Requires-Dist: pdoc>=15.0.0 ; extra == 'dev'
Requires-Python: >=3.12
Provides-Extra: dev
Description-Content-Type: text/markdown

# augint-mono

CLI tools for coordinating monorepos with git submodules.

## Installation

```bash
uv add --dev augint-mono
```

## Usage

```bash
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:

```bash
# 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
```
