Skip to content
Migration Guide

How to Export an Emergent Project to GitHub

The official GitHub integration in four steps, plus a manual fallback that works even if the UI changes.

Official path: Emergent's GitHub integration

  • Click your profile icon in Emergent and select Connect GitHub, then authorize access on GitHub's login screen. The connection persists for future sessions.
  • Click Save to GitHub in the chat interface.
  • Choose a new repository or select an existing one, and pick your branch (main for new projects).
  • Click PUSH TO GITHUB — Emergent pushes the codebase with automatic commit messages.

After the push, verify on GitHub: files present, default branch correct, and no secrets committed. Save to GitHub again whenever you want to push new changes to the same repository and branch.

Fallback: manual export with plain git

If you cannot use the integration — or the UI changes — this tool-agnostic path always works:

  • Create an empty GitHub repository first (recommended baseline).
  • Copy the project files from Emergent's code view onto your machine.
  • Initialize local git and push the exported source to GitHub.
  • Verify files, default branch, and secret hygiene on GitHub.

Verification

Verified against Emergent's official GitHub integration documentation on August 27, 2026. An earlier version of this guide predated that documentation and used only the manual fallback flow.

Continue in Claude Code, Cursor, or any coding agent

Once the project is on GitHub, you are no longer tied to Emergent. Clone the repository to your machine and run your coding agent — Claude Code, Cursor, Codex — directly in the project folder. The agent now works on your real codebase with full git history, instead of inside the builder's sandbox. And when you want planned features instead of one-off prompts, Feature1 connects your repo so agents implement against approved acceptance criteria.

Frequently asked questions

Can I continue developing my Emergent project in Claude Code?

Yes. Export the project to GitHub using the steps above, clone the repository to your machine, and start Claude Code in the project directory. From that point Claude Code works on your real codebase — Emergent is no longer required. The same applies to Cursor, Codex, or any agent that works on a local repository.

Is it free to push my Emergent code to GitHub?

Yes. Git is free, and GitHub's free plan includes unlimited private repositories. The push itself costs nothing — the only thing to check is whether your Emergent plan gives you access to the project's code output.

What if I cannot use the GitHub integration?

Use the manual fallback in this guide: copy the project files from Emergent's code view onto your machine, then init, commit, and push with plain git. This path works regardless of what the tool's UI offers.

More export guides