gat remote

Usage: gat remote <COMMAND>

Commands:
  default  Show or choose the default remote. Adding a remote never chooses it
  list     List all configured remotes
  add      Add a named remote
  update   Update an existing remote, preserving its stable name. Omitted flags
           keep their current values
  remove   Remove a named remote
  show     Show a remote's redacted URL, default status, and defining scope.
           Reads the effective configuration merged across every scope. Whole
           `${VAR}` query references and sanitized Azure endpoints remain
           visible. Userinfo, literal query secrets, and fragments are hidden.
           Display never reads environment variables or opens a backend
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help (see a summary with '-h')

Usage: gat remote add [OPTIONS] <NAME> <URL>

Arguments:
  <NAME>
          Name to add the remote under (`default` is reserved)

  <URL>
          Remote URL (`file://`, `s3://`, `azblob://`, `gcs://`, or `oss://`,
          subject to enabled build features); may contain `${VAR}` references,
          expanded from the environment every time gat runs (quote the argument
          so your shell doesn't expand it first), instead of writing a
          secret-bearing URL (e.g. one with a SAS token or embedded credentials)
          into `gat.yaml`

Options:
      --global
          Write to the global config (`~/.gat/gat.yaml`), applying to every
          repository for this user

      --project
          Write to the project config (`<repo_root>/gat.yaml`), committed to git
          and shared with everyone who clones the repo. The default

      --local
          Write to the local config (`<repo_root>/.gat/gat.yaml`), repo-local
          and never committed (`.gat/` isn't tracked)

  -h, --help
          Print help (see a summary with '-h')

Usage: gat remote default [OPTIONS] [NAME]

Arguments:
  [NAME]
          Existing remote to choose; omit to show the current default

Options:
      --unset
          Remove this scope's choice and inherit from lower layers

      --global
          Write to the global config (`~/.gat/gat.yaml`), applying to every
          repository for this user

      --project
          Write to the project config (`<repo_root>/gat.yaml`), committed to git
          and shared with everyone who clones the repo. The default

      --local
          Write to the local config (`<repo_root>/.gat/gat.yaml`), repo-local
          and never committed (`.gat/` isn't tracked)

  -h, --help
          Print help (see a summary with '-h')

Usage: gat remote list

Options:
  -h, --help
          Print help (see a summary with '-h')

Usage: gat remote remove [OPTIONS] <NAME>

Arguments:
  <NAME>
          Name of the remote to remove

Options:
      --global
          Write to the global config (`~/.gat/gat.yaml`), applying to every
          repository for this user

      --project
          Write to the project config (`<repo_root>/gat.yaml`), committed to git
          and shared with everyone who clones the repo. The default

      --local
          Write to the local config (`<repo_root>/.gat/gat.yaml`), repo-local
          and never committed (`.gat/` isn't tracked)

  -h, --help
          Print help (see a summary with '-h')

Usage: gat remote show <NAME>

Arguments:
  <NAME>
          Name of the remote to inspect

Options:
  -h, --help
          Print help (see a summary with '-h')

Usage: gat remote update [OPTIONS] <NAME>

Arguments:
  <NAME>
          Name of the remote to update

Options:
      --url <URL>
          New URL template; may contain `${VAR}` references (see `add`)

      --global
          Write to the global config (`~/.gat/gat.yaml`), applying to every
          repository for this user

      --project
          Write to the project config (`<repo_root>/gat.yaml`), committed to git
          and shared with everyone who clones the repo. The default

      --local
          Write to the local config (`<repo_root>/.gat/gat.yaml`), repo-local
          and never committed (`.gat/` isn't tracked)

  -h, --help
          Print help (see a summary with '-h')