원문 캡처 · github.com
원문 캡처 · github.com

HAR는 AI 코딩 에이전트마다 격리된 작업 공간을 제공하고, 프로젝트의 검증 절차와 실행 증거를 기록하는 오픈소스 도구다. CLI와 MCP 서버로 제공되며 Claude Code, Cursor, Codex와 모든 MCP 에이전트에서 사용할 수 있다. 한 에이전트부터 여러 에이전트까지 같은 절차로 실행하고 관리할 수 있도록 설계됐다.

HAR 저장소에는 릴리스와 테스트 워크플로도 공개돼 있다. 소개 데모 영상에서 동작을 확인할 수 있다.

HAR에는 핵심 실행 도구인 HAR, 로컬 대시보드 Mission Control, 기능을 확장하는 플러그인이 포함된다. Mission Control은 프로젝트 전반의 저장소, 작업 공간, 실행, 검증 결과와 산출물을 한곳에서 추적한다.

설치와 시작

전역 설치 명령은 다음과 같다.

bash
npm install -g @osfactory/har

저장소 디렉터리에서 har onboard로 .har/ 설정을 만들고 코딩 에이전트에 전달할 프롬프트를 출력한다. 다음 명령은 1번 에이전트 슬롯에 격리된 작업 공간과 실행 중인 스택을 준비하고, 프로젝트의 실제 검사 항목을 전체 실행해 통과한 항목을 기록한다.

bash
cd my-app
har onboard # scaffold .har/ and print a prompt for your coding agent
har env launch 1 # isolated worktree + running stack for agent slot 1
har env verify 1 --full # run the project's real checks, record what passed

자세한 절차는 빠른 시작 안내에서 볼 수 있다.

작업 격리와 검증 방식

HAR는 프로젝트의 스택, 스크립트, 사용 가능한 검사 항목을 담은 계약을 에이전트가 확인하도록 한다. 이 계약은 저장소 안의 .har/에 두며, Claude Code, Cursor, Codex 또는 MCP 에이전트가 같은 방식으로 읽는다. 제작진은 README, CLAUDE.md, Cursor 규칙, CI 설정에 흩어져 서로 달라질 수 있는 프로젝트 실행·검증 정보를 하나의 기계 판독 가능한 계약으로 관리한다고 설명한다.

각 작업은 별도의 슬롯에서 진행된다. 슬롯마다 저장소 복사본과 브랜치, 포트가 분리되며 프로젝트에 데이터베이스가 필요한 경우 데이터베이스도 따로 둔다. 따라서 메인 체크아웃이나 다른 에이전트 슬롯과 자원을 공유하지 않고, 여러 에이전트가 동시에 작업할 수 있다. 에이전트는 이 격리된 복사본 안에서 코드를 수정하고 테스트하며, 메인 체크아웃은 그대로 둔다.

검증 단계에서는 프로젝트 자체의 검사 항목을 매번 같은 파이프라인으로 실행한다. 전체 검증은 검사 시점의 코드베이스 상태도 기록해 통과 결과가 어떤 코드에 해당하는지 확인할 수 있도록 한다. 실행 로그와 산출물, 검증된 트리 해시도 증거로 남긴다. 검증이 끝나면 세션은 종료되지만 브랜치와 실행 증거는 보존되므로 검토자는 에이전트의 자체 보고에만 의존하지 않고 코드와 검증 자료를 함께 살펴볼 수 있다.

HAR가 해결하려는 문제에는 에이전트끼리 개발 서버·데이터베이스·포트·Git 상태를 공유하며 충돌하는 상황, 변경 사항을 사람이 다시 검증해야 하는 부담, 특정 플랫폼에 검증 설정이 묶이는 문제가 포함된다. 또 스택이 바뀌어 수작업 스크립트가 오래된 상태로 남는 문제에 대응하는 har env maintain 명령도 제공한다. 이 명령은 설치된 하네스와 최신 템플릿의 차이를 비교해 설정이 달라진 부분을 표시한다.

문서와 프로젝트 정보

문서 사이트에는 핵심 개념, 에이전트 연동, 검증과 커밋 게이트, 플러그인, CLI 참조, MCP 도구, Mission Control 사용법과 아키텍처 안내가 있다.

기여를 위한 로컬 설정과 개발 절차는 CONTRIBUTING.md, 저장소에서 작업하는 코딩 에이전트가 먼저 읽을 안내는 AGENTS.md, 관리자의 릴리스 절차는 RELEASING.md에 정리돼 있다. HAR는 Apache License 2.0으로 제공되며, 보안 취약점은 SECURITY.md에 안내된 방법으로 신고할 수 있다.