Phorge

Phorge is Git infrastructure for coding agents. It gives agents a clone-free API for reading files, creating commits, managing branches, and inspecting history. Standard Git clone, fetch, and push over HTTPS remain available.

Repositories stay available through the same API and Git URLs when work pauses. Nothing is removed merely for being idle.

Get started

Install the TypeScript SDK with npm install phorge.

import { GitStorage } from "phorge";

const store = new GitStorage({
  name: "your-org",
  key: env.privateKey,
});

const repo = await store.createRepo({ id: "new-workspace" });

const result = await repo
  .createCommit({
    targetBranch: "main",
    commitMessage: "Initialize workspace",
    author: { name: "Agent", email: "agent@example.com" },
  })
  .addFileFromString("README.md", "# Hello\n")
  .send();

console.log(result.commitSha);

The private key stays in your process. The SDK uses it to sign short-lived, narrowly scoped JWTs. Phorge stores only the corresponding public key.

What it supports

• File-operation and unified-diff commits in one request.
• Expected-head checks and branch-scoped credentials for concurrent agents.
• File reads, byte ranges, grep, blame, diffs, history, and tar.gz archives without cloning.
• Branch, merge, and tag operations without a working tree.
• Finite repository lifetimes, storage quotas, and usage accounting.
• Stock Git clone, fetch, and push over HTTPS.

Phorge is made by The San Francisco Tooling Company.

For inquiries, email hi@sf.tools. Send press inquiries to press@sf.tools.