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

# vers repo delete

Delete repositories by name. All tags inside them are removed (cascade via FK). The commits those tags pointed at are **not** deleted.

## Synopsis

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo delete <name>...
```

## Description

Accepts one or more repo names. Each is deleted independently; if one fails, the command keeps going and reports the first error on exit.

<Warning>
  Commits remain, but the named pointers to them are gone. If you want a specific commit back later, you'll need its commit ID or another tag (possibly a legacy `commit_tags` entry) that still points at it. Export `vers repo tag list <repo> --format json` before you delete anything you might want to rebuild.
</Warning>

## Examples

### Delete one repo

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo delete my-app
# ✓ Repository 'my-app' deleted
```

### Delete several

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo delete staging experiments scratch
# ✓ Repository 'staging' deleted
# ✓ Repository 'experiments' deleted
# ✓ Repository 'scratch' deleted
```

### Delete them all (dangerous)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo delete $(vers repo list -q)
```

## Error Cases

### Repository not found

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo delete ghost
# ✗ Failed to delete repository 'ghost': Repository not found
```

The command continues with any remaining names and returns the first error at the end.

## See Also

* [`vers repo tag delete`](/cli-reference/repo-tag-delete) - remove individual tags without destroying the repo
* [`vers repo list`](/cli-reference/repo-list)