Install
npm install -g @jeger-ai/opengantryOr use it per-project:
npx @jeger-ai/opengantry init --tutorialVerify the CLI is available:
gantry --version
gantry doctorBootstrap your repo
From your project root:
gantry init --tutorialThis scaffolds:
| Artifact | Role |
|---|---|
.gitagent/missions/ | Mission YAML scope and gate commands |
.gitagent/foreman/MANIFEST.json | Skill routing, TMVC roots, risk tiers |
.gitagent/planner/RULES.md | Governance law |
.githooks/ | Pre-commit and pre-push enforcement |
EXECUTOR_LOG.md | Verbatim PASS quotes for verify |
Set your Planner identity:
export GANTRY_PLANNER_EMAILS="$(git config user.email)"Your first mission
1. Legislate scope
gantry legislate "hello world mission" --msn MSN-0001 --skill-key gantryThe Planner commits [MSN-0001] with the mission YAML. Review the generated file under .gitagent/missions/.
2. Pin and bootstrap runtime
scripts/gxt-pin-mission.sh .gitagent/missions/MSN-0001.*.yaml
source scripts/gxt-runtime-env.shWire MCP (gantry mcp serve) and hooks in your agent harness for the full closed loop. See the integration guide for Cursor, Claude Code, and other tools.
3. Execute within scope
Do your work within the mission’s TMVC roots. Append trace evidence to EXECUTOR_LOG.md with verbatim PASS quotes.
4. Verify
gantry verify --mission .gitagent/missions/MSN-0001.*.yamlOn failure, use --json for structured findings[] that external agents can retry against:
gantry verify --mission .gitagent/missions/MSN-0001.*.yaml --jsonDiscover existing conventions
Already have a codebase? Scan before legislating:
gantry init --discover --domain code
gantry blueprint --domain code --yesFor markdown or HTML corpora:
gantry init --discover --domain content
gantry blueprint --domain content --yesNext steps
| Goal | Resource |
|---|---|
| 5-minute adoption guide | docs/ADOPTION.md |
| Domain adapters | docs/DOMAINS.md |
| External agent integration | docs/AGENT-LOOP.md |
| Content governance example | examples/content-governance |
| Contributing | docs/DEVELOPMENT.md |
Package links
- GitHub: github.com/jeger-ai/opengantry
- npm: @jeger-ai/opengantry