Harnery

Multi-agent coordination + harness adapters + portable CLI utilities for Claude Code / Cursor / Codex.

⚠️ Pre-1.0. API surface is still settling. Pin a specific minor version (harnery@^0.1.0) and read the CHANGELOG before each upgrade.

What it is

harnery is a utility layer extracted from years of building agent tooling across a multi-project monorepo. It bundles:

• Multi-agent coordination: per-agent heartbeats in .harnery/active/, claim-time and commit-time guards, the canonical event stream, harness adapters for Claude Code / Cursor / Codex.
• Portable CLI utilities: tokens, eml, env, grep, docs, repo, wip, share, browse, fetch, read, and more. Cross-platform and dependency-light, with sensible defaults out of the box.
• Standalone web UI: harn web up boots a local Next.js dashboard for the coord layer, councils, and per-project state. Ships with the git clone, not the npm package (see Install).
• Backup + sync: harn backup snapshots .harnery/ via restic; harn sync keeps a curated subset live across machines via rclone (Google Drive or any rclone remote).

Install

npm install -g harnery

Or as a per-project dep:

npm install harnery

Then:

harn --help
harn doctor   # one-time runtime + dep check

npm gives you the engine + CLI. The web/ dashboard and the docs/ site live in the git repo, not the npm package (which is the CLI + coord engine: bin, dist, src, schemas). To run the dashboard, git clone the repo, bun install, and harn web up from there, pointing it at your project with --coord-root <dir> (or just run it from inside the project). harn web up prints these exact steps if you invoke it without the clone present.

Use as a CLI library

Project-specific CLIs compose Harnery's command tree and add their own commands on top:

// mycli/src/program.ts
import { createHarneryProgram } from 'harnery/commander';
import { deployCommand, dbCommand } from './commands';

const program = createHarneryProgram({
  binName: 'mycli',
  context: { projectName: 'my-monorepo' },
});

program.addCommand(deployCommand);
program.addCommand(dbCommand);

await program.parseAsync(process.argv);

mycli agents status then resolves to the same code as harn agents status, loaded as a library. See examples/extending-with-commander.ts for the full pattern.

Documentation

Full docs at harnery.com:

• Getting started
• CLI reference
• Concepts
• Configuration schema

Contributing

See CONTRIBUTING.md. Bug reports and feature requests via GitHub Issues.

License

MIT © Ryan Kelly