Files
docs/cli-docs/reference/repo/fork.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

2.2 KiB

sidebar_position, description
sidebar_position description
7 Fork a repository

gt repo fork

Fork a repository

Synopsis

Fork a repository for your account, or into an organization with --org. An existing fork is
reported instead of failing.

--clone clones the fork (Git flags can follow --). Inside a clone of the repository, --remote adds
the fork as "origin" and renames the current "origin" to "upstream".
gt repo fork [<repository>] [-- <gitflags>...] [flags]

Examples

# Fork the repository of the current clone and add the fork as origin
$ gt repo fork --remote

# Fork a repository into an organization under another name
$ gt repo fork alice/project --org acme --fork-name project-fork

# Fork and clone a repository
$ gt repo fork alice/project --clone -- --depth 1

Options

      --clone                Clone the fork
      --fork-name string     Name of the fork (default: the repository's name)
  -h, --help                 help for fork
      --org string           Fork into this organization
      --remote               Add the fork as a remote of the current clone
      --remote-name string   Name of the fork's remote (default "origin")

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