Quickstart

Install the Package

Add ClaudeEssentials to your project:

dotnet add package ClaudeEssentials

Install-Package ClaudeEssentials

For AOT publishing, ensure your project targets .NET 8+ and has PublishAot enabled.

Create a Hook Processor

Create a console app that reads JSON from stdin and writes the response to stdout:

Program.cs

using CloudNimble.ClaudeEssentials.Hooks;
using CloudNimble.ClaudeEssentials.Hooks.Enums;
using CloudNimble.ClaudeEssentials.Hooks.Outputs;

// Read hook input from stdin
var inputJson = Console.In.ReadToEnd();

// Deserialize the input
var input = ClaudeHooksSerializer.DeserializePreToolUseInput(inputJson);

// Create your response
var output = new PreToolUseHookOutput<object>
{
    Continue = true,
    HookSpecificOutput = new PreToolUseSpecificOutput<object>
    {
        PermissionDecision = PermissionDecision.Allow,
        PermissionDecisionReason = "Auto-approved by policy"
    }
};

// Write JSON to stdout
Console.WriteLine(ClaudeHooksSerializer.SerializePreToolUseOutput(output));

Configure Claude Code

Add your hook to Claude Code’s settings.json:

settings.json

{
  "hooks": {
    "PreToolUse": [{
      "command": "dotnet run --project /path/to/your/project"
    }]
  }
}

For production, publish your app as a native executable for faster startup:

dotnet publish -c Release

Test It Out

Start a Claude Code session. Your hook will now intercept tool calls and apply your custom logic.

You’re ready to customize Claude’s behavior with strongly-typed C# code!

Common Patterns

Auto-approve safe tools

if (input.ToolName is "Read" or "Glob" or "Grep")
{
    return new PreToolUseHookOutput<object>
    {
        Continue = true,
        HookSpecificOutput = new PreToolUseSpecificOutput<object>
        {
            PermissionDecision = PermissionDecision.Allow
        }
    };
}

Block dangerous commands

var command = input.ToolInput?.ToString() ?? "";
if (command.Contains("rm -rf"))
{
    return new PreToolUseHookOutput<object>
    {
        Continue = true,
        HookSpecificOutput = new PreToolUseSpecificOutput<object>
        {
            PermissionDecision = PermissionDecision.Deny,
            PermissionDecisionReason = "Dangerous command blocked"
        }
    };
}

Add context after tool execution

return new PostToolUseHookOutput
{
    Continue = true,
    HookSpecificOutput = new PostToolUseSpecificOutput
    {
        AdditionalContext = "Remember to run tests after making changes."
    }
};

Next Steps

API Reference

Explore all available types and methods

Hook Inputs

Learn about input models for each hook type

⌘I

Getting Started

Guides

API Reference

Common Patterns

Next Steps

API Reference

Hook Inputs

​Common Patterns

​Next Steps

API Reference

Hook Inputs

Common Patterns

Next Steps