claudomat

claudomat

A .NET global tool that orchestrates the Claude Code command-line interface. It adds resilient execution with rate-limit handling, session resumption, cumulative budget tracking, optional batch workflows, and optional Azure DevOps boards integration.

This package is published as a .NET tool (PackAsTool). Install it with the .NET CLI; it does not add library references to your projects.

Requirements

• .NET 10 SDK (install from Microsoft’s .NET download pages; version requirements follow the package’s target framework)
• Claude Code CLI available on PATH (install and sign-in per the product documentation from your AI vendor)
• For Azure DevOps features: a personal access token (PAT) supplied at runtime—never embedded in source control

Install

From the public NuGet gallery (when the package is listed there):

dotnet tool install -g claudomat

From an example private feed (replace with your own registry URL and credentials flow):

dotnet nuget add source "https://nuget.contoso.com/v3/index.json" --name contoso-internal
dotnet tool install -g claudomat --add-source contoso-internal

Update a global tool installation:

dotnet tool update -g claudomat

Quick start

Run a single prompt in a repository folder:

claudomat run "Summarize the README" --budget 1.00 --working-dir ./sample-repo

Run a batch file of tasks (JSON format as described in the full project documentation):

claudomat batch ./tasks.json --budget 10.00 --working-dir ./sample-repo

Process work items from an Azure DevOps project (example URL shape only):

claudomat boards "https://dev.azure.com/contoso/SampleProject" --budget 25.00 --azdo-pat %AZURE_DEVOPS_PAT%

On Linux or macOS, prefer "$AZURE_DEVOPS_PAT" or another secret injection mechanism instead of hard-coding tokens.

Authentication and environment variables

The tool does not store long-lived secrets inside the package. Configure credentials through your environment or explicit CLI options at invocation time, for example:

CLI flags may mirror these variables for one-off runs; refer to claudomat --help and subcommand help for the current option names.

Never commit PATs, API keys, or OAuth tokens to source control or share them in issue trackers.

Commands (overview)

Use claudomat [command] --help for authoritative flags and defaults.

Data and logs

The tool may create a local metadata folder (for example .claudomat) under the working directory and append cost information under the user profile. Review paths in your environment before running in sensitive trees.

License and support

This package is licensed under the MIT License; the full text is included as LICENSE inside the NuGet package. The License tab on the NuGet gallery (when published) reflects the same terms. For bugs or features, use the contact or issue URL published alongside the package (if any)—do not send credentials or internal URLs in public reports.

Example hostnames and organizations (contoso.com, contoso, SampleProject) are illustrative only and are not real endpoints.