Files
docs/cli-docs/reference/repo/set-default.md
T
bircni 55c3a392a1 feat: generate the gt command reference from gitea/cli
update_cli_docs.sh runs gt's own generator and lays the pages out for the
site: one directory per command group, front matter, titles, sidebar
order, fenced help text and rewritten links. --released succeeds while no
series is documented. A weekly workflow proposes updates like the runner's.

Signed-off-by: bircni <[email protected]>
2026-10-22 11:28:15 +02:00

1.9 KiB

sidebar_position, description
sidebar_position description
11 Set the default repository for this clone

gt repo set-default

Set the default repository for this clone

Synopsis

Set the repository that gt commands use in the current Git clone instead of the one of its Git
remotes (saved as gt.repository in the clone's Git configuration).
gt repo set-default [<repository>] [flags]

Examples

# Make gt commands in this clone use the fork's parent
$ gt repo set-default alice/project

# Show the saved repository
$ gt repo set-default --view

# Go back to the repository of the Git remotes
$ gt repo set-default --unset

Options

  -h, --help    help for set-default
  -u, --unset   Remove the saved default repository
  -v, --view    Print the saved default repository

Options inherited from parent commands

      --cwd directory       Working directory for repository discovery
      --debug               Log the method, URL, status, and duration of each HTTP request to stderr
      --host URL            Gitea instance URL, including any base path
      --interactive         Allow prompts with machine output
  -q, --jq expression       Filter JSON output using a jq expression; implies --json
      --json fields[="*"]   Output JSON with the specified comma-separated fields, or all fields
      --no-input            Disable prompts and implicit editor/browser interactions
      --remote remote       Git remote used for repository discovery
  -R, --repo OWNER/REPO     Select a repository as OWNER/REPO or URL
      --sudo user           Perform API requests as this user (requires an administrator account)
      --user name           Account name on the selected instance
  -y, --yes                 Accept confirmations without prompting

SEE ALSO

  • gt repo: Work with Gitea repositories