Chargehand

Runs coding-agent workers on a codebase question; every claim in the answer carries evidence.

LLM Mart 4 views 197 listing impressions

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, and code, 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.

Related servers

Universal MCP Server with advanced AI memory capabilities and semantic search.

30 views

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

28 views

Let Codex orchestrate external coding agents through their native harnesses.

28 views

Control plane MCP for scoped recon, triage, and bounded proofs.

27 views