Declarative GitHub infrastructure management via YAML. Like Terraform, but for GitHub — no state file required.

gh infra plan    # Show what would change
gh infra apply   # Apply the changes

📖 babarot.github.io/gh-infra — Full YAML reference, usage patterns, and guides.

The Terraform GitHub Provider covers most GitHub-as-Code use cases, but it's overkill for personal or small-team use — provider installation, HCL, state files, and state locking add real overhead before you can change a single setting.

gh-infra takes a different approach:

• YAML instead of HCL. Declare what your repos should look like in plain YAML.
• No state file. GitHub itself is the source of truth. Every plan fetches the live state and diffs directly — there's nothing to store, lock, or lose.
• plan before apply. See exactly what will change before it happens. Most alternatives (Probot Settings, GHaC) apply immediately with no preview.
• One file, many repos. A single RepositorySet can enforce consistent settings across dozens of repositories. No more clicking through the UI one repo at a time.
• Just gh and a token. No GitHub App, no server, no extra infrastructure. If you can run gh, you can run gh infra.

gh extension install babarot/gh-infra

Install gh-infra skills for your coding agent (Claude Code, Copilot, Codex, Cursor, etc.):

# via GitHub CLI (v2.90.0+)
gh skill install babarot/gh-infra

# via npx
npx skills add babarot/gh-infra

This gives your agent knowledge of gh-infra commands, YAML schema, and CI/CD patterns so it can write and manage manifests for you.

gh infra import babarot/my-project > my-project.yaml

  apiVersion: gh-infra/v1
  kind: Repository
  metadata:
    name: my-project
    owner: babarot

  spec:
    description: "My awesome project"
    visibility: public
    topics:
      - go
      - cli
    features:
      issues: true
-     projects: false
+     projects: true
      wiki: false
      discussions: true

gh infra plan
gh infra apply

plan, apply, and validate accept an optional [path] argument:

YAML files that are not gh-infra manifests (e.g., GitHub Actions workflows, docker-compose) are silently skipped. Use --fail-on-unknown to treat them as errors instead.

For full documentation — YAML reference, usage patterns, and guides — visit babarot.github.io/gh-infra.

MIT