Branches and Git Operations

The Git API (Level 2) provides programmatic access to branches, commit history, and diffs without needing a local git binary.

Status: log() and diff() are fully functional. createBranch(), listBranches(), deleteBranch(), and merge() require server-side RPCs that haven’t shipped yet — calling them will throw an error.

Quickstart

import { Client } from "@githosted/sdk";

const client = new Client();
const repo = client.repo("my-project");

// View commit history
const commits = await repo.log({ limit: 10 });

// Get a diff between two branches
const diff = await repo.diff("main", "feature/new-api");

API Reference

repo.log(options?)

Get the commit log.

// Recent commits
const commits = await repo.log({ limit: 20 });
for (const c of commits) {
  console.log(`${c.hash.slice(0, 7)} ${c.subject} (${c.authorName})`);
}

// Commits on a specific branch
const commits = await repo.log({ ref: "develop", limit: 10 });

// Commits touching a specific file
const history = await repo.log({ path: "src/main.ts", limit: 5 });

Each commit has: hash, authorName, authorEmail, committedAt (Date), subject.

repo.diff(baseRef, headRef)

Get the diff between two refs.

const diff = await repo.diff("main", "feature/new-api");
console.log(diff.patch); // unified diff output

repo.createBranch(name, options?)

Create a new branch.

const branch = await repo.createBranch("feature/new-api", { from: "main" });

repo.listBranches()

List all branches.

const branches = await repo.listBranches();
for (const b of branches) {
  console.log(`${b.name} ${b.isDefault ? "(default)" : ""}`);
}

repo.merge(source, options)

Merge a branch.

const result = await repo.merge("feature/new-api", {
  into: "main",
  message: "Merge feature/new-api",
});

Next Steps

• Reading and Writing Files
• Atomic Transactions