gat selection

Usage: gat selection <COMMAND>

Commands:
  list     List effective selections and mark the default
  show     Show a selection, its filters, and defining scope
  add      Save a complete selection without changing the default
  update   Update a definition in its existing scope; omitted fields are
           preserved
  remove   Remove this scope's definition; a lower definition may become
           effective
  default  Show or set the default; unset restores inheritance from lower layers
  help     Print this message or the help of the given subcommand(s)

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

Usage: gat selection add [OPTIONS] <NAME>

Arguments:
  <NAME>
          Saved selection name

Options:
      --path <PATH>
          Select this file or subtree. Any explicit --path, --include, or
          --exclude replaces the complete configured selection. Use --path . for
          the whole repository. For mount add, omission selects the source root;
          repository selection defaults never apply to mounts

      --include <INCLUDE>
          Glob pattern (matched relative to `--path`) selecting which paths to
          include. Repeatable. Component-aware: `*.bin` matches only immediate
          children, while `**/*.bin` matches recursively. Empty means everything
          under `--path`

      --exclude <EXCLUDE>
          Glob pattern (matched relative to `--path`) excluded from `--include`
          (or from everything under `--path`, if `--include` is empty).
          Repeatable. Component-aware like `--include`; exclude always wins over
          include

      --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 selection default [OPTIONS] [NAME]

Arguments:
  [NAME]
          Existing selection to choose; omit to show the current choice

Options:
      --unset
          Remove this scope's default pointer and restore inheritance

      --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 selection list

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

Usage: gat selection remove [OPTIONS] <NAME>

Arguments:
  <NAME>
          Saved selection name

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 selection show <NAME>

Arguments:
  <NAME>
          Saved selection name

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

Usage: gat selection update [OPTIONS] <NAME>

Arguments:
  <NAME>
          Saved selection name

Options:
      --path <PATH>
          New literal repository-root-relative path

      --include <INCLUDE>
          Replace include patterns, relative to the saved path

      --exclude <EXCLUDE>
          Replace exclusions, relative to the saved path

      --clear-include
          Remove all saved include restrictions

      --clear-exclude
          Remove all saved exclusions

      --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')