Repos

Why a repo

cimplify deploy builds the exact commit you push. The project needs a git remote to push that commit to. Each project has exactly one attached repo: either a Cimplify-managed repo, or an external remote you own.

Managed repo

Cimplify hosts the repo for you. This is the default and needs no git credentials of your own.

# Mint a managed repo for the linked project
cimplify repo provision

# Optional: name hint and default branch
cimplify repo provision --name my-store --branch main

With a managed repo attached, cimplify deploy mints a short-lived push token and pushes for you. You never configure origin and no long-lived credentials touch your machine.

If you want to push manually (e.g. outside cimplify deploy):

# Print a fresh authenticated push URL (token TTL is short)
cimplify repo clone-url

# One-shot push
git push "$(cimplify repo clone-url)" main

Connect your own

Bring an existing GitHub, Gitea, or other remote:

cimplify repo connect https://github.com/you/store.git
git remote add origin https://github.com/you/store.git

For connected repos, cimplify deploy runs a plain git push origin <branch> using your existing git auth. origin must be set locally.

Inspect & manage

# Show the attached repo: provider, remote_url, default branch, last push
cimplify repo info

# Rotate the managed repo's push credential (re-provision is idempotent)
cimplify repo rotate-token

# Detach the repo from the project (managed upstream is preserved)
cimplify repo unlink

# Detach and DELETE the managed upstream repo
cimplify repo unlink --purge

Subcommands

Troubleshooting

cimplify deploy fails with 'origin' does not appear to be a git repository:

The project has no repo wired, or you have a managed repo but no local origin. Either provision a managed repo (then cimplify deploy pushes for you), or connect your own and add the origin remote:

# Managed
cimplify repo provision
cimplify deploy --prod

# Or your own
cimplify repo connect <url>
git remote add origin <url>
cimplify deploy --prod

Do not point origin at an unrelated GitHub repo to "make the error go away"; managed-repo builds clone from Cimplify's managed host, not GitHub, so a push to GitHub lands somewhere the build never reads.

Where next

• deploy Ship the pushed commit; preview and production.

• domains Add, verify, attach a custom domain.

• CLI overview Full index.