The steps every tool shares are on Wire any agent. Below are the context file, bootstrap and gotchas for each remaining tool.
OpenCode
-
Context: the repository-root
AGENTS.md, loaded natively aftergantry init. Optionally:{ "instructions": ["AGENTS.md", ".gitagent/planner/RULES.md"] } -
Bootstrap: OpenCode does not run project hook directories; use the shell wrapper.
scripts/gxt-pin-mission.sh .gitagent/missions/MSN-0001.<slug>.yaml scripts/gxt-shell-agent.sh opencode .gitagent/missions/MSN-0001.<slug>.yaml -
Enforcement: advisory;
opencode.jsonpermissions are separate from OpenGantry scope. -
Gotcha: OpenCode prefers
AGENTS.mdoverCLAUDE.mdwhen both exist.
JetBrains Junie
- Context:
.junie/AGENTS.md, with the same bullets as the rootAGENTS.md. Use it rather than generic AI Assistant project rules. - Bootstrap: in the IDE terminal,
source scripts/gxt-runtime-env.sh <mission>. - Enforcement: advisory; in-IDE edits are not trapped.
Google Antigravity
- Context: the root
AGENTS.md, optionally.agent/rules/gxt.mdwithalways_onpointing at the canonical files. - Bootstrap:
source scripts/gxt-runtime-env.sh <mission>, organtry runtime exec … -- <command>. - Enforcement: advisory in the Editor and Manager views; process boundary for wrapped CLI runs.
- Gotcha: rules load in the order
GEMINI.md,AGENTS.md,.agent/rules/. Keep the OpenGantry pointers inAGENTS.md.
Cline
- Context:
.clinerules/gxt.md; the rootAGENTS.mdalso appears in the Rules panel. - Bootstrap: in the VS Code terminal,
source scripts/gxt-runtime-env.sh <mission>. - Enforcement: advisory. Toggle rules in the Cline panel without deleting files.
- Gotcha: Cline also reads legacy
.cursorrules; prefer.clinerules/gxt.mdfor OpenGantry policy.
Aider
-
Context: list the canonical files in
.aider.conf.yml:read: - AGENTS.md - .gitagent/planner/RULES.md - .gitagent/foreman/MANIFEST.yaml -
Bootstrap:
gantry runtime exec --mission .gitagent/missions/MSN-0001.<slug>.yaml -- aider --message "<task>" -
Enforcement: process boundary when wrapped, the strongest trap among common IDE-adjacent tools.
gantry hook installarms the tracked pre-commit hook (gantry hook pre-commit) so its TMVC guard rejects staged paths outside the mission; the bypass isgit commit --no-verifyonly. -
Scope file:
gantry runtime env --aiderwrites.gitagent/tmp/aider-tmvc-scope.mdand, when.aider.conf.ymlexists, adds it underread:once. Aider has no directory allowlist, so the pre-commit gate is what stops the commit. Harnesses such aspiread the space-separatedGANTRY_TMVC_ROOTSfromgantry runtime env. -
Gotcha: run from the repository root;
read:paths resolve from the working directory.
OpenHands
- Context:
.openhands/microagents/gxt.mdpointing at the canonical files, plus the rootAGENTS.md. Keep the microagent short: linkAGENTS.md, do not duplicate RULES. - Bootstrap:
source scripts/gxt-runtime-env.sh <mission>, then run OpenHands against the repository. - Enforcement: advisory for in-IDE edits; process boundary when wrapped with
gantry runtime exec.