@mergora/gora

Gora is the Growth Oriented Repo Autopilot CLI for Mergora.

MVP capabilities:

• Run-based audit output in .runs/<taskId>/<runId>/...
• Iterative "fix until green" loop using Codex CLI (codex exec --json)
• Thin GitHub Actions integration via gora init --workflow

Install / run

npm i -g @mergora/gora
gora --help

Or:

npx -y @mergora/gora@latest --help

Repo setup (MVP)

Create .mergora.yml using JSON-compatible YAML (YAML is a superset of JSON):

{
  "task": { "prd": "prd/PRD-00-Bootstrap.md" },
  "run": { "maxIters": 5 },
  "validate": { "cmd": "bash .github/scripts/ci.sh" },
  "gates": { "denyWorkflows": true, "denyLockfiles": true }
}

Generate a starter workflow stub:

gora init --workflow

Then in a PR comment:

/gora run

Required secret (MVP)

CODEX_AUTH_JSON_B64 – base64 of ~/.codex/auth.json from a machine where codex login has already been done.