Skip to main content

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.

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 for the full model.

Synopsis

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

OptionDescription
--description, -dOptional description shown in vers repo list and vers repo get

Examples

Create a repo for your app

vers repo create my-app
# ✓ Repository 'my-app' created (1f2aabcd-1234-5678-9abc-def012345678)

Create with a description

vers repo create ml-checkpoints -d "Frozen VM snapshots at each training milestone"

Error Cases

Name already exists

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

vers repo create "my app"
# Error: Invalid name
Solution: use alphanumerics, hyphens, underscores, or dots. No spaces.

See Also