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

# Repo create

# vers repo create

Create a named repository in your org. Repositories are containers for tags, and tags are named pointers to commits. See [Repositories and Tags](/repositories) for the full model.

## Synopsis

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo create <name>
vers repo create <name> --description "text"
```

## Description

Creates an empty repository scoped to your organization. The repo is private by default; publish it later with `vers repo visibility`. Repo names must be 1-64 characters and may contain letters, digits, hyphens, underscores, and dots.

## Options

| Option                | Description                                                        |
| --------------------- | ------------------------------------------------------------------ |
| `--description`, `-d` | Optional description shown in `vers repo list` and `vers repo get` |

## Examples

### Create a repo for your app

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo create my-app
# ✓ Repository 'my-app' created (1f2aabcd-1234-5678-9abc-def012345678)
```

### Create with a description

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo create ml-checkpoints -d "Frozen VM snapshots at each training milestone"
```

## Error Cases

### Name already exists

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo create my-app
# Error: Repository already exists
```

**Solution:** pick a different name, or delete the existing repo with `vers repo delete my-app` (this does not delete the commits inside it).

### Invalid name

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo create "my app"
# Error: Invalid name
```

**Solution:** use alphanumerics, hyphens, underscores, or dots. No spaces.

## See Also

* [`vers repo list`](/cli-reference/repo-list)
* [`vers repo tag create`](/cli-reference/repo-tag-create)
* [Repositories and Tags](/repositories)