create-repo

Create a repo for an owner locator or self

Auth

Authenticated Owner Scope

Example

pearing-cli create-repo \
  --name "Website" \
  --description "Customer-facing marketing site" \
  --about "# Website\n\nCustomer-facing marketing site." \
  --slug website \
  --visibility private \
  --default-branch main
# or
# pearing-cli create-repo \
#   --owner teams/platform \
#   --name "Website" \
#   --slug website \
#   --visibility private \
#   --default-branch main
# or
# pearing-cli create-repo \
#   --owner alice \
#   --name "Website" \
#   --slug website \
#   --visibility private \
#   --default-branch main

Expected Response

Creates the resource and prints the created JSON object.

Errors

400 Bad Request for invalid flags/values.
404 Not Found when referenced owners/resources are missing.
409 Conflict for uniqueness or state conflicts.

Common auth errors are documented on the CLI overview page.

Help Output

Create a repo for an owner locator or self.

Usage: pearing-cli create-repo [OPTIONS] --name <NAME> --slug <SLUG> --visibility <VISIBILITY> --default-branch <DEFAULT_BRANCH>

Options:
      --owner <OWNER>                    Owner locator (`teams/<team_slug>` or `<username>`). Defaults to authenticated user
      --name <NAME>                      Repo name
      --description <DESCRIPTION>        Repo description
      --about <ABOUT>                    Repo about markdown
      --slug <SLUG>                      Repo slug
      --visibility <VISIBILITY>          Repo visibility [possible values: public, private]
      --default-branch <DEFAULT_BRANCH>  Default branch name
  -h, --help                             Print help (see more with '--help')