We’ve added support for ephemeral branches — a fully isolated, disposable branch namespace designed for LLM driven workflows.

Ephemeral branches live in a separate ref space and never sync to GitHub. They remain completely isolated from your default branches until explicitly promoted, while sharing underlying Git objects to keep storage efficient and fetches fast.

Ephemeral branches are accessed using standard Git operations via a dedicated remote — no special tooling required.

git remote add ephemeral https://git.example.com/org/repo+ephemeral.git
git push ephemeral preview/pr-123

Alternatively, you can also leverage our createCommit method to create new ephemeral git’s dynamically.

await repo.createCommit({
  targetBranch: 'preview/pr-123',
  baseBranch: 'main',
  ephemeral: true,
  commitMessage: 'Preview environment for PR 123',
});

Ephemeral branches can later be promoted into your normal branch namespace when ready for production.

await repo.promoteEphemeralBranch({
  baseBranch: 'preview/pr-123',
});

Important notes

• Ephemeral branches are fully isolated until promotion
• They are not mirrored to GitHub
• Git objects are shared for efficiency
• Access is via Git protocol and SDKs

See the docs →