gat route

Usage: gat route <COMMAND>

Commands:
  list    List all configured routes, plus a synthetic `*` row showing the
          repository default remote that applies when no route matches
  add     Add a new named route: tracked paths at or beneath `PATH` are served
          by `REMOTE`, unless a more specific route overrides it. `REMOTE` must
          already be a named remote (`gat remote add` it first). Fails if `NAME`
          already exists in the selected scope -- use `route update` to change
          an existing route. A route selects storage only -- it never changes
          which mount (if any) owns `PATH`. `NAME` `*` is reserved for `route
          list`'s synthetic default-remote row and cannot be used
  update  Update an existing route in place, preserving its stable `NAME`. Any
          flag you omit keeps the route's current value
  remove  Remove a named route. Only removes that route definition from the
          selected scope; never touches mount configuration, `gat.lock`
          ownership, remotes, or other routes
  show    Show everything about one configured route: its name, normalized path,
          remote, and which config layer defines it. Reads the effective config
          merged across every scope
  help    Print this message or the help of the given subcommand(s)

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

Usage: gat route add [OPTIONS] <NAME> <REMOTE> <PATH>

Arguments:
  <NAME>
          Stable route identity and `routes:` config key

  <REMOTE>
          Name of an existing remote to route `PATH` to

  <PATH>
          Root-relative path this route applies to (and everything beneath it,
          unless overridden by a more specific route)

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

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

Usage: gat route remove [OPTIONS] <NAME>

Arguments:
  <NAME>
          Name of the route 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 route show <NAME>

Arguments:
  <NAME>
          Name of the route to inspect

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

Usage: gat route update [OPTIONS] <NAME>

Arguments:
  <NAME>
          Name of the route to update (its stable `routes:` config key)

Options:
      --remote <REMOTE>
          New remote to route to (keeps the current remote if omitted). Must
          already be a named remote

      --path <PATH>
          New path this route applies to (keeps the current `path` if omitted)

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