Ephemeral Branch Reads

Ephemeral branches are now available across the read APIs that agents use most often: branch listing, commit history, and search.

You can opt into the ephemeral namespace when listing branches, reading commits, or running grep. The default behavior stays unchanged, so existing calls continue to resolve refs against persistent branches unless you explicitly ask for ephemeral refs.

const branches = await repo.listBranches({ ephemeral: true });

const commits = await repo.listCommits({
  branch: 'preview/pr-123',
  ephemeral: true,
});

const matches = await repo.grep({
  pattern: 'TODO',
  ref: 'preview/pr-123',
  ephemeral: true,
});

branches = await repo.list_branches(ephemeral=True)

commits = await repo.list_commits(
    branch="preview/pr-123",
    ephemeral=True,
)

matches = await repo.grep(
    pattern="TODO",
    ref="preview/pr-123",
    ephemeral=True,
)

This makes ephemeral branches feel like a complete working namespace for automated workflows. Agents can create disposable work, inspect what changed, search it, and decide what to promote without cloning a repository or leaking temporary branches into the persistent namespace.

See the docs →

Ephemeral Branch Reads

+ UP NEXT +