← Build on your apps

Push an existing project

Built an app in Claude Code or Codex? Push it to Onvoi from your terminal, exactly like pushing to GitHub — Onvoi is just another remote.

Create an app to push into

Open Apps → + Create an app → Develop with Claude Code or Codex and give it a name. The app starts empty, so your history goes in as-is — no merge, no force-push. Onvoi then shows a one-command setup (see Build with Claude Code or Codex) and, below it, the plain Git commands with your app’s real address.

The two commands

A brand-new project:

terminal
git init
git add -A
git commit -m "first commit"
git branch -M main
git remote add onvoi https://git.onvoi.ai/<workspace>/<app>.git
git push -u onvoi main

A project that already has a history (and maybe a GitHub origin):

terminal
git remote add onvoi https://git.onvoi.ai/<workspace>/<app>.git
git push -u onvoi main
Why “onvoi”The remote is named onvoi, not origin, so a project that already pushes to GitHub keeps doing that.

Signing in

Git asks for a username and password. The username can be anything; the password is an Onvoi Git token — not your Onvoi password. Make one on Build on your apps or in the app’s Source & advanced → Clone with Git. Let Git remember it with git config --global credential.helper osxkeychain (Mac) or store.

What a push does

  • Your project has no onvoi.yaml? Onvoi reads it (package.json, Dockerfile, .env.example…) and proposes a settings file as a change for you to review. Nothing fails.
  • Onvoi builds a private preview of every push.
  • Going live always waits for an approval — in Onvoi, by a person.
  • Push again whenever you like; each push is a new version.
  • Only plans or docs so far? The push is kept and shown as “plans and docs only” — not a failed build.
  • Every push shows its own status on the app page (and in onvoi status): received, checking, building, preview ready, waiting for approval, live.

Who can push to main

The app’s admin (whoever created it) pushes straight to main. Everyone else pushes a branch — git push onvoi HEAD:my-change — and publishes it from Onvoi. Either way, nothing goes live without approval.