Pixelbadger.ClaudeAgentSdk 0.3.2

Pixelbadger.ClaudeAgentSdk

A C# port of the Anthropic Claude Agent SDK — the same tools, agent loop, and context management as Claude Code, for .NET.

Upstream TypeScript reference: typescript-sdk@0.2.117

Installation

dotnet add package Pixelbadger.ClaudeAgentSdk

Quick Start

V1 API — single query

using Pixelbadger.ClaudeAgentSdk;
using Pixelbadger.ClaudeAgentSdk.Messages;

await foreach (var message in AgentSdk.Query("What files are in the current directory?"))
{
    if (message is SdkAssistantMessage assistant)
        Console.WriteLine(assistant.Text);
}

V1 API — warm (pre-started) query

await using var warm = await AgentSdk.Startup();

await foreach (var msg in warm.Query("Hello!"))
    Console.WriteLine(msg);

V2 API — session (multi-turn)

using Pixelbadger.ClaudeAgentSdk;

await using var session = await AgentSdkV2.CreateSession();

await foreach (var msg in session.Stream("List the files here"))
    Console.WriteLine(msg);

await foreach (var msg in session.Stream("Now summarise them"))
    Console.WriteLine(msg);

Options

using Pixelbadger.ClaudeAgentSdk.Options;
using Pixelbadger.ClaudeAgentSdk.Permissions;

var options = new AgentOptions
{
    Model = "claude-opus-4-7",
    PermissionMode = PermissionMode.AcceptEdits,
    MaxTurns = 10,
    SystemPrompt = new FixedSystemPromptConfig("You are a helpful assistant."),
};

await foreach (var msg in AgentSdk.Query("Do something", options))
    Console.WriteLine(msg);

In-process MCP tools

AgentSdk.Tool("get_weather", "Return weather for a city", inputSchema, async (input, ct) =>
{
    var city = input.GetProperty("city").GetString();
    return new { temperature = 22, unit = "C", city };
});

var options = new AgentOptions
{
    McpServers = [AgentSdk.CreateSdkMcpServer()]
};

await foreach (var msg in AgentSdk.Query("What's the weather in London?", options))
    if (msg is SdkAssistantMessage a) Console.WriteLine(a.Text);

Live query control

var session = AgentSdk.QueryWithControl("Analyse this repo", options);
await foreach (var msg in session.Messages)
{
    if (shouldStop) await session.Control.Interrupt();
}

Message Types

All messages derive from SdkMessage and are deserialized polymorphically:

See CHANGELOG.md for the full list of ported message types.

Requirements

• .NET 8.0 or later
• Claude Code CLI installed and on PATH (npm install -g @anthropic-ai/claude-code)

License

MIT