Chargehand
Runs coding-agent workers on a codebase question; every claim in the answer carries evidence.
An orchestrator for coding agents (Claude Code, OpenCode): send a question or a change, get back typed JSON where every claim cites a file at a pinned commit.
Active. I work on it this month.
flowchart LR caller[You or a program<br/>CLI · HTTP · MCP] -- request --> intake[Intake<br/>picks an action] intake -- answer or split --> workers[Agent sessions<br/>Claude Code or OpenCode] intake -- ask · deny · improve --> result workers -- claims + citations --> resolver[Evidence resolver<br/>checks each citation] resolver --> result[Typed result<br/>claims · open questions · cost] workers -. code preset, driven batches .-> branch[Tested branch<br/>or draft pull request] resolver --> log[(Run log<br/>tokens · cache · prompts)]
Why
Coding agents answer in prose. A program that calls one needs something it can check: claims tied to files at a commit, diffs, session messages or the caller's own inputs, plus a confidence and the exact prompts behind the answer. I also wanted the control flow (the task graph, budgets, retries, parallelism) in code rather than in a prompt, so each agent's context stays small, cached and disposable.
What it does
- Answers with checked citations. A citation is a file and line range, a commit, a diff range, a session message or an input id. Each one must exist at the pinned commit before a claim leaves its worker; the worker gets one repair turn, and claims that still fail move to open questions.
- Splits a question into 2 to 4 read-only subtasks run as a task graph, when intake chooses it and the preset allows it. Later subtasks reuse the first one's cached prompt prefix.
- Presets set the tools, the token and dollar budgets and the allowed actions:
default,cheap,thorough,strict,draft(for programs that bring their own facts),review, andcode, which writes a branch that passes its tests in a sandbox. - Driven batches run a list of tasks as parallel Claude Code sessions, one locked-down container each, and end each in a draft pull request.
- Plugs into your tools. An MCP server (stdio or HTTP), an HTTP API, a CLI, a Claude Code plugin
(
/chargehand:change: one prompt to a reviewed change on a local branch) and an operator console in the browser. - Measures itself. The run log records tokens, cache hits, cost and the prompt chain of every call; Prompt CI gates prompt and preset changes on paired evals before they merge.
Not here: an agent loop of its own, direct calls to model providers, a model gateway, a memory store (it uses yours over MCP), a hosted service. A citation that resolves points at something that exists; checking that the cited text supports the claim is planned, not built (roadmap).
Warning
Before 1.0. The images have no latest tag: pin an exact version and read the changelog before you upgrade.
Quick start
From a clone, ask one question about chargehand itself. Needs the .NET 10 SDK, git, and Claude Code 2.1.283 on
PATH, signed in (run claude once). With no profile, the workers use the CLI's own login and default model.
git clone https://github.com/Egoushka/chargehand.git && cd chargehand
cat > request.json <<EOF
{
"contract_version": "request/v1",
"text": "Where does a split node decide whether to fork the first node's session? Cite the code.",
"context": { "interactive": false, "preset": "default",
"repository": { "path": "$PWD", "commit": "$(git rev-parse HEAD)" } }
}
EOF
dotnet run --project src/Chargehand.Cli -- run < request.json
It prints result/v1 on stdout: claims with citations, open questions, a confidence and the cost. The
quickstart guide explains every field, OpenCode instead of Claude Code, and what to do
when a run fails.
To use it from an MCP client without a clone, run the package from nuget.org with dnx, pinned to a release:
From the project's README.