lfnovo

Harny — Development skill for Claude Code

Development community

A light-weight harness for Claude Code development.

How to install Harny

This entry records only its repository, not the path inside it, so there is no exact command to give. Open lfnovo/harny and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Harny does

A light-weight harness for Claude Code development.

Alternatives in Development

Explore Harness 24.1k ★
IPolloWork — Enterprise-grade, local-first Agent Workbench for people and agent teams 4.9k ★
Petdex — A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and 4k ★

README

Harny

Harny is a local-first workflow runtime for auditable AI-assisted software development. Workflows are declarative YAML DAGs, can mix Claude and Codex, persist resumable state locally, and keep privileged effects such as commits and pull-request publication outside the agents.

Install

Requires Bun 1.3+ and Git.

bun add -g @lfnovo/harny
# or
bunx @lfnovo/harny "implement the requested feature"

Claude workflows use the Claude Agent SDK authentication. Codex nodes use the pinned official Codex SDK and the user's existing Codex authentication/config; a separately installed Codex executable is not required. GitHub PR delivery uses the installed `gh` CLI. Tokens never belong in workflow YAML or Harny's provider config.

Quick start

# Planner → sequential tasks → developer/validator retry → validated commits
harny "add JSON export to the CLI"

# Also push and create/update a draft GitHub PR
harny --workflow feature-pr "add JSON export to the CLI"

# Load an explicit workflow file
harny --workflow ./.harny/workflows/custom.yaml "run the custom workflow"

# Address review feedback on the current repository's existing PR
harny pr fix 123

Each normal run creates an isolated `harny/` branch and Git worktree. `--isolation inline` is available when isolation is not wanted.

New to agent harnesses? Start with the [Harny documentation](docs/README.md). It provides a progressive user path and a separate development path for contributors.

Runtime model

Workflow loading is:

YAML → schema validation → static validation → normalized DAG → scheduler

Named workflow precedence is:

/.harny/workflows > ~/.harny/workflows > bundled workflows

Markdown commands use the equivalent `commands/` precedence. Validation occurs before worktree creation or provider cost and checks duplicate IDs, missing dependencies, cycles, output references, retry bounds, human timeouts, provider capabilities, and reachable outco