claudomat

claudomat

A .NET global tool that orchestrates the Claude Code CLI for automation: resilient runs with rate-limit backoff and session resumption, cumulative budget tracking, optional live dashboard (batch and boards), JSON session reports, and deep Azure DevOps integration (boards, PRs, work items, and pipeline tasks).

The NuGet package is PackAsTool only—it installs an executable named claudomat; it does not add library references to your projects. The package also ships the MCP tools assembly next to the tool so built-in azdo and complexity MCP servers can be loaded for agent sessions.

Requirements

• .NET 10 runtime/SDK line compatible with the package’s target framework
• Claude Code CLI on PATH (install and sign in per your vendor’s documentation)
• For Azure DevOps: a PAT or pipeline token at runtime—never commit secrets

Install

dotnet tool install -g claudomat

Update:

dotnet tool update -g claudomat

Private feed example:

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

Commands

Use claudomat [command] --help for every flag and default.

Quick examples

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

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

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

claudomat pr 42 "Review for security issues." --repo-url "https://dev.azure.com/contoso/proj/_git/repo" --working-dir ./pr-src --budget 5.00 --azdo-pat %AZURE_DEVOPS_PAT%

On Linux/macOS, prefer "$AZURE_DEVOPS_PAT" or your secret manager instead of literals.

Notable features

• Rate limits: Retries with backoff; optional stream verbosity (--stream-verbose where supported).
• Branch guardrails: --exclude-branch (repeatable); default include renovate/* unless --no-default-branch-excludes.
• Boards — agent roles: --role (e.g. developer, tester, pr-reviewer) drives tagged Task / tagged backlog discovery and handoff; --process selects a named multi-role chain (e.g. software-development). Without --role, backlog items tagged for pipeline roles are skipped unless --include-roles. Role pipeline Tasks are picked up only when To Do / New, or In Progress and stale (default 2 hours after state change) so concurrent runs do not duplicate active work.
• PR command roles: --role on pr applies fixed reviewer-style instructions; without --role, PRs that carry a pipeline role label are skipped unless --include-roles.
• MCP: --mcp-feed + optional --mcp-feed-pat syncs NuGet packages tagged mcp-server into merged MCP config. In Azure Pipelines, SYSTEM_ACCESSTOKEN can authenticate the feed when mapped. Built-in azdo and complexity tools ship in the tool package.
• Dashboard: Rich live task status for batch and boards unless --no-dashboard.
• Verbose discovery: boards --verbose logs more backlog rows during scans.

Environment and CLI secrets

Never commit tokens or PATs.

Data and logs

The tool may create .claudomat metadata under the working tree and write logs/cost data under the user profile. Inspect paths in regulated environments before running.

License

This package includes the MIT LICENSE file. The License tab on the gallery mirrors it when published.

Examples use fictitious names (contoso, SampleProject) and are not real endpoints.