VcsManager · .NET 10

One API.
Any Git provider.

A unified .NET abstraction for GitHub, GitLab, Azure DevOps, and Gitea. Create repositories and pull requests, merge or close them, and add retries, timeouts, logging, and telemetry without changing your application code.

Get started View on GitHub

Works with

GitHub
GitLab
Azure DevOps
Gitea

Program.csVcsManager.GitHub

ConfigureGitHubwith one builder

// GitHub
var provider = new VcsProviderBuilder()
    .WithGitHub(options =>
    {
        options.Token = Environment
            .GetEnvironmentVariable("VCS_GITHUB_TOKEN");
        options.DefaultOwner = "my-org";
    })
    .Build();

Read the GitHub guide →

One contract, every provider

Repository and pull request automation that stays portable when the provider changes.

Unified API

Create, list, get, and delete repositories. Create, list, get, merge, and close pull requests through one contract.

Four providers

Use GitHub, GitLab, Azure DevOps, or Gitea without changing your application logic. Swap the package and configuration.

Modular packages

The core package has no provider SDK. Install only the provider packages your application uses.

Pagination and errors

One page shape with nullable totals and provider-driven next-page metadata. One exception family for every provider.

Operational layers

Add retries, timeouts, concurrency limits, logging, and OpenTelemetry without modifying provider code.

Flexible configuration

Configure with the fluent API, environment variables, or YAML. The last configuration source wins.

Start with the core package

$dotnet add package VcsManager.Core

Installation guide →

Configure your way

Fluent API
Environment
YAML

Program.cs
using VcsManager;
using VcsManager.Builder;
using VcsManager.GitHub;

await using var provider = new VcsProviderBuilder()
    .WithGitHub(options =>
    {
        options.Token = Environment.GetEnvironmentVariable("VCS_GITHUB_TOKEN");
        options.DefaultOwner = "my-org";
    })
    .Build();

var repository = await provider.GetRepositoryAsync(new RepositoryRef
{
    Owner = "my-org",
    Name = "payments-api",
});

Console.WriteLine(repository.FullName);

Terminal
export VCS_PROVIDER=github
export VCS_GITHUB_TOKEN=<token>
export VCS_GITHUB_DEFAULT_OWNER=my-org

# In your C# code:
var provider = new VcsProviderBuilder()
    .WithGitHub()
    .FromEnvironment()
    .Build();

vcs.yaml
# vcs.yaml
provider:
  github:
    token: <token>
    default:
      owner: my-org

Program.cs
var provider = new VcsProviderBuilder()
    .WithGitHub()
    .FromYamlFile("vcs.yaml")
    .Build();

One API.Any Git provider.