> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# repo

> Manage Entire repositories and GitHub mirror placements.

Manage Entire repositories.

```bash theme={null}
entire repo COMMAND
```

## repo create

Create a repository in a project.

```bash theme={null}
entire repo create NAME [flags]
```

| Flag                  | Description                                                                          |
| --------------------- | ------------------------------------------------------------------------------------ |
| `--cluster-host HOST` | Public host of the cluster to pin the repo to. Defaults to the jurisdiction default. |
| `--project PROJECT`   | Owning project name or ULID. Required.                                               |

## repo list

List repositories in a project.

```bash theme={null}
entire repo list PROJECT [flags]
```

## repo get

Show a repository by name or ULID.

```bash theme={null}
entire repo get REPO [flags]
```

| Flag                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--project PROJECT` | Owning project name or ULID. Required when `REPO` is a name. |

## repo delete

Delete a repository by name or ULID.

```bash theme={null}
entire repo delete REPO [flags]
```

| Flag                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `-f, --force`       | Skip the confirmation prompt.                                |
| `--project PROJECT` | Owning project name or ULID. Required when `REPO` is a name. |
| `-y, --yes`         | Skip the confirmation prompt. Alias for `--force`.           |

## repo mirror create

Create a mirror placement for an existing GitHub repository.

```bash theme={null}
entire repo mirror create [GITHUB_URL] [CLUSTER_HOST] [flags]
```

With no arguments, `entire repo mirror create` opens an interactive wizard to choose repositories and regions.

With a GitHub URL, the command registers a mirror for that repo on the target cluster, then waits for the initial GitHub-to-Entire clone to finish. The default cluster host is `aws-us-east-2.entire.io`.

Examples:

```bash theme={null}
entire repo mirror create
entire repo mirror create github.com/octocat/hello-world
entire repo mirror create github.com/octocat/hello-world aws-us-east-2.entire.io
```

| Flag                      | Description                                                                  |
| ------------------------- | ---------------------------------------------------------------------------- |
| `--no-wait`               | Return once the mirror is registered, without waiting for the initial clone. |
| `--wait-timeout DURATION` | How long to wait for the initial clone. Defaults to `30m0s`.                 |

## repo mirror remove

Remove a mirror placement for a GitHub repository from the target cluster.

```bash theme={null}
entire repo mirror remove GITHUB_URL [CLUSTER_HOST] [flags]
```

The default cluster host is `aws-us-east-2.entire.io`. Removing a mirror placement does not delete or rewrite the upstream GitHub repository.

Example:

```bash theme={null}
entire repo mirror remove github.com/octocat/hello-world
```

## repo mirror collaborators list

List users with access to a mirror.

```bash theme={null}
entire repo mirror collaborators list GITHUB_URL [CLUSTER_HOST] [flags]
```

This command is read-only. Mirror access follows GitHub collaborator permissions and syncs hourly. The caller must be a live GitHub admin of the upstream organization repository, or the owner of a user-owned repository.

Example:

```bash theme={null}
entire repo mirror collaborators list github.com/acme/widget
```

## Continue with

<CardGroup cols={2}>
  <Card title="Mirror a GitHub Repository" icon="clone" href="/learn/mirror-a-github-repository">
    Create a mirror and use it from Git.
  </Card>

  <Card title="Mirror Access and Permissions" icon="lock" href="/guides/repositories/mirror-access-and-permissions">
    Understand GitHub-synced access, hourly collaborator sync, and offboarding.
  </Card>
</CardGroup>