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:
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):
git remote add onvoi https://git.onvoi.ai/<workspace>/<app>.git git push -u onvoi main
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.