## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.entire.io/llms.txt)

Use this file to discover all available pages before exploring further.

Manage Entire repositories.

```
entire repo COMMAND
```

## repo create

Create a repository in a project.

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

```
entire repo list PROJECT [flags]
```

## repo get

Show a repository by name or ULID.

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

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

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

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

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

```
entire repo mirror remove github.com/octocat/hello-world
```

## repo mirror collaborators list

List users with access to a mirror.

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

```
entire repo mirror collaborators list github.com/acme/widget
```

## Continue with

[**Mirror a GitHub Repository** 
\
Create a mirror and use it from Git.](https://docs.entire.io/learn/mirror-a-github-repository)

[**Mirror Access and Permissions** 
\
Understand GitHub-synced access, hourly collaborator sync, and offboarding.](https://docs.entire.io/guides/repositories/mirror-access-and-permissions)
