Skip to main content
// Get file from default branch
const resp = await repo.getFileStream({ path: "README.md" });
const text = await resp.text();
console.log(text);

// Get file from specific branch, tag, or commit
const historicalResp = await repo.getFileStream({
  path: "package.json",
  ref: "v1.0.0", // branch name, tag, or commit SHA
});
const historicalText = await historicalResp.text();

// Fetch from the ephemeral namespace
const ephemeralResp = await repo.getFileStream({
  path: "notes.md",
  ref: "feature/demo-work",
  ephemeral: true,
});

Options

ParameterTypeDescription
pathRequiredPath to the file within the repository
refOptionalBranch name, tag, or commit SHA. Defaults to the default branch.
ephemeralOptionalWhen true, resolves the ref under the ephemeral namespace.

Returns

Returns a standard Fetch Response object (TypeScript) or an async response object (Python) that can be used to stream or read the file content.