Metadata-Version: 2.4
Name: gator-command
Version: 1.6.0
Summary: Git-native governance for AI-assisted engineering
Author-email: Cumberland Laboratories <support@cumberlandlaboratories.com>
License: MIT
Project-URL: Homepage, https://github.com/cumberland-laboratories/gator
Project-URL: Repository, https://github.com/cumberland-laboratories/gator
Keywords: governance,ai,git,charters,audit,compliance
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Gator Command

**Git-native governance for AI-assisted engineering.**

Gator turns your repo into an intelligence surface. The AI agent builds structured maps of your codebase (charters), a strategic operations brief (pulse), and project assessments — all committed to Git. A deterministic pre-commit gate blocks commits when the agent changes code without updating the map.

Local-first. Git-native. Works with Claude Code, Codex, Gemini CLI. MIT licensed.

## Install

```bash
pip install pipx        # if you don't have pipx yet
pipx ensurepath         # add to PATH (restart terminal after)

pipx install gator-command
```

## Quick Start

```bash
cd /path/to/your/repo

gator gatorize .        # install governance into this repo
gator init              # start a governed session
gator dashboard         # open the intelligence console
```

The agent reads the governance layer and orients to your project. Your first `git commit` fires the hooks.

## Upgrade

```bash
pipx upgrade gator-command

cd /path/to/your/repo
gator gatorize .        # refresh templates and hooks
```

Your content is always preserved. Only templates and scripts refresh.

## Commands

| Command | What it does |
|---------|-------------|
| `gator gatorize <path>` | Install or upgrade governance in a repo |
| `gator init` | Start a governed session (repairs hooks if needed) |
| `gator dashboard` | Open the intelligence console |
| `gator pulse` | Generate the strategic operations brief |
| `gator audit` | Run governance audit |
| `gator version` | Show installed version |

## What Gator Provides

- **Repo intelligence** — charters map code structure, pulse summarizes momentum, assessments provide AI-generated evaluation. All committed to Git.
- **Governance enforcement** — a deterministic pre-commit hook that blocks commits when code changes without charter updates. No LLM in the gate. Configurable: strict, warn, or off.
- **Dashboard** — a local web console for browsing your governance layer, session history, and project state. Full file history with git version navigation.
- **Session persistence** — the governance layer carries project context across sessions and across models. Switch from Claude to Codex mid-project without losing architectural understanding.

## How It Works

1. `gator gatorize .` installs a `.gator/` folder into your repo with governance scaffolding
2. AI agents read the constitution and charters to understand your codebase
3. Every `git commit` runs a deterministic hook that validates charter-alongside-code
4. Session snippets capture what context produced each commit
5. `gator dashboard` makes it all browsable in a local web UI

## Links

- [Source code](https://github.com/cumberland-laboratories/gator)
- [MIT License](https://github.com/cumberland-laboratories/gator/blob/main/LICENSE)

---

Built by [Cumberland Laboratories](https://github.com/cumberland-laboratories)
