Getting started

Install Fugaro. One line.

Install Fugaro on macOS or Linux.

Pick your platform

supported

macOS

The Homebrew cask (tested on macOS).

brew install dimipaun/tap/fugaro

From README.md · macOS

Desktop console

Learn more

untested

Windows

Windows is untested: this repository builds no Windows binary.

Then set up your installation.

Set up your installation

Three steps, once. The install gets you the CLI; these get you an installation.

  1. gcloud, Terraform and repository access

    gcloud credentials with a quota project, Terraform 1.9+, and repository access: a GitHub App with four repository permissions on GitHub, or a repository access token on Bitbucket.

    Preconditions
  2. Run fugaro setup

    In your own terminal. It asks for the GCP project, the region, whether to create it or adopt one, and the name; the rest is a confirmation you type, and secrets come at hidden prompts. The shared budget is optional.

    The short path
  3. Run /fugaro:setup

    In your coding agent. Merge the pull request, then run fugaro setup again.

    The short path

Other install paths

Cosign

Check the archive against the release's checksums.

V=X.Y.Z
gh release download v$V -R dimipaun/fugaro -p checksums.txt -p checksums.txt.sigstore.json -p "fugaro_${V}_$(uname -s | tr A-Z a-z)_*"
cosign verify-blob checksums.txt \
  --bundle checksums.txt.sigstore.json \
  --certificate-identity "https://github.com/dimipaun/fugaro/.github/workflows/release.yml@refs/tags/v$V" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
grep " fugaro_${V}_$(uname -s | tr A-Z a-z)_" checksums.txt | shasum -a 256 -c -      # macOS
grep " fugaro_${V}_$(uname -s | tr A-Z a-z)_" checksums.txt | sha256sum -c -         # Linux

From docs/release.md · macOS, Linux

Go install

For development only: a dev version with no release images and no plugin pin.

go install github.com/dimipaun/fugaro/cmd/fugaro@latest

From README.md · macOS, Linux

Plugin

The agent's skills; fugaro setup wires them into the checkout.

fugaro setup
/fugaro:setup
fugaro upgrade --local

From README.md · macOS, Linux