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. Apache 2.0 licensed.
Install
pip install pipx # if you don't have pipx yet
pipx ensurepath # add to PATH (restart terminal after)
pipx install gator-command
Quick Start
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
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
gator gatorize .installs a.gator/folder into your repo with governance scaffolding- AI agents read the constitution and charters to understand your codebase
- Every
git commitruns a deterministic hook that validates charter-alongside-code - Session snippets capture what context produced each commit
gator dashboardmakes it all browsable in a local web UI
Links
Built by Cumberland Laboratories
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gator_command-2.12.2-py3-none-any.whl.
File metadata
- Download URL: gator_command-2.12.2-py3-none-any.whl
- Upload date:
- Size: 552.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a61a527b1ba9b50f8130ee04bede3466368c0ae0b37b2a5f315df3ed1848b530
|
|
| MD5 |
d9898a5611be2e6953a43156f7941117
|
|
| BLAKE2b-256 |
8886fbf2e54d93a98edb5f760d35fd1f145e6f474a9170b73b0e62b07ac824ec
|
Provenance
The following attestation bundles were made for gator_command-2.12.2-py3-none-any.whl:
Publisher:
promote-to-pypi.yml on cumberland-laboratories/gator
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gator_command-2.12.2-py3-none-any.whl -
Subject digest:
a61a527b1ba9b50f8130ee04bede3466368c0ae0b37b2a5f315df3ed1848b530 - Sigstore transparency entry: 2703032553
- Sigstore integration time:
-
Permalink:
cumberland-laboratories/gator@3e9d648a300f015334e5788df4ecd89c1bafd4d5 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/cumberland-laboratories
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
promote-to-pypi.yml@3e9d648a300f015334e5788df4ecd89c1bafd4d5 -
Trigger Event:
workflow_dispatch
-
Statement type:
