gion

Git workspaces, as code.

Define workspaces in YAML, then plan/apply to reconcile safely. Reproducible by default, safe for bulk operations.

Why gion

Reproducible inventory

Workspace inventory lives in gion.yaml, reconciled via plan/apply.

Bulk create & cleanup

Create and remove many workspaces with diffs and confirmations for deletions.

Multi-repo tasks

Presets bundle multiple repos into a single task workspace.

Many entry points

Start from repos, presets, or PRs/issues and reconcile in one apply.

Quickstart (via README)

The README is the source of truth for install and the command flow. Start there, then come back for the overview.

Install

Homebrew

brew tap tasuku43/gion

brew install gion

mise

mise use -g github:tasuku43/gion@<version>

Direct download

Download the prebuilt binaries and put gion on your PATH.

Workflow

1) Declare in gion.yaml
2) gion plan (diff only)
3) gion apply (confirm destructive changes)

FAQ

Do I need gh?

Only for --issue and --review modes (GitHub).

Is deletion safe?

plan surfaces risky deletions before apply.