SDKs

npm install @gitforge/sdk

bun add @gitforge/sdk

import { GitForge } from "@gitforge/sdk";

const gf = new GitForge({
  token: "gf_YOUR_PAT",
  // Optional: override base URL for self-hosted instances
  baseUrl: "https://api.gitforge.dev",
});

const repos = await gf.repos.list();
for (const repo of repos) {
  console.log(`${repo.name} — ${repo.description}`);
}

const repo = await gf.repos.create({
  name: "my-project",
  description: "Created via SDK",
  visibility: "private",
});
console.log(repo.id);

const branches = await gf.repos.branches.list(repo.id);
for (const branch of branches) {
  console.log(`${branch.name} — ${branch.sha}`);
}

const pr = await gf.repos.prs.create(repo.id, {
  title: "Add feature",
  description: "Implements new feature",
  sourceBranch: "feature/new-thing",
  targetBranch: "main",
});
console.log(`PR #${pr.number}: ${pr.title}`);

pip install gitforge-sdk

poetry add gitforge-sdk

from gitforge import GitForge

gf = GitForge(
    token="gf_YOUR_PAT",
    # Optional: override base URL for self-hosted instances
    base_url="https://api.gitforge.dev",
)

repos = gf.repos.list()
for repo in repos:
    print(f"{repo.name} — {repo.description}")

repo = gf.repos.create(
    name="my-project",
    description="Created via SDK",
    visibility="private",
)
print(repo.id)

# List open PRs
prs = gf.repos.prs.list(repo.id, state="open")
for pr in prs:
    print(f"PR #{pr.number}: {pr.title}")

# Create a PR
pr = gf.repos.prs.create(
    repo.id,
    title="Add feature",
    source_branch="feature/new-thing",
    target_branch="main",
)

# Merge a PR
gf.repos.prs.merge(repo.id, pr.number, strategy="squash")

go get github.com/gitforge/gitforge-go

package main

import (
    "context"
    gitforge "github.com/gitforge/gitforge-go"
)

func main() {
    client := gitforge.NewClient("gf_YOUR_PAT")
    // Optional: override base URL
    // client.BaseURL = "https://api.gitforge.dev"
    ctx := context.Background()
}

repos, err := client.Repos.List(ctx, nil)
if err != nil {
    log.Fatal(err)
}
for _, repo := range repos {
    fmt.Printf("%s — %s\n", repo.Name, repo.Description)
}

repo, err := client.Repos.Create(ctx, &gitforge.CreateRepoRequest{
    Name:        "my-project",
    Description: "Created via SDK",
    Visibility:  "private",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(repo.ID)

pr, err := client.PullRequests.Create(ctx, repo.ID, &gitforge.CreatePRRequest{
    Title:        "Add feature",
    Description:  "Implements new feature",
    SourceBranch: "feature/new-thing",
    TargetBranch: "main",
})
if err != nil {
    log.Fatal(err)
}
fmt.Printf("PR #%d: %s\n", pr.Number, pr.Title)