The package holds the parts of an agent run that do not depend on the daemon's queue or config: git worktrees, pull request helpers, repo verification, run containment, the Claude Agent SDK runner, model sizing and the logger.

Dependency direction is agent → harness → shared. Importing from @gethmy/agent here is never correct.

Installation

Most users never install this package directly. @gethmy/agent depends on it, and the hmy front door carries it too:

npm i -g @gethmy/cli

Building your own driver? Depend on @gethmy/harness from your driver's package.json rather than installing it globally.

Prerequisites

Node.js >= 20 or Bun >= 1.0
Git
Claude Code available to the agent SDK

Diagnostics

hmy harness resolutions [--probe-sdk]

Prints what this delivery resolves — the claude executable and the MCP server launch — as JSON. --probe-sdk starts a real SDK query far enough to capture the executable the SDK decided to spawn, then aborts it.