HAR documentation

HAR turns the unwritten knowledge required to run a repository into an editable .har/ contract. Coding agents and developers use the same commands to create isolated worktrees, launch services, verify changes, collect artifacts, and hand off a validated branch.

Project-owned

The scripts, stage registry, environment settings, and agent instructions live in your repository. Review and adapt them like any other code.

Agent-agnostic

Use the CLI directly, connect any MCP-capable agent, or install managed workflows for Cursor, Claude Code, and Codex.

Isolated by default

Every slot gets a fresh session worktree, its own environment, and—when your stack needs them—isolated ports and databases.

Evidence, not promises

HAR records runs, artifacts, exact validated tree hashes, and optional commit gates so reviewers can see what actually passed.

The shortest useful workflow

npm install -g @osfactory/har
har env init
har env launch 1
# Make changes only in the work dir printed by launch.
har env verify 1 --full
har env complete 1

HAR is not a coding model, test runner, or CI/CD replacement. It is the stable operating contract that lets those systems work with a real repository safely.