hlock은 에이전트의 하네스와 모델, MCP 서버, 스킬, 플러그인, 지침 파일, 설정을 harness.lock에 기록해 다른 컴퓨터에서도 복원하도록 돕는 도구다. 제작자는 Claude Code, Codex, Pi, OpenCode와 OpenClaw 같은 에이전트를 지원한다고 설명한다.

빠른 시작 문서에서 설치 방법을 확인할 수 있으며, 프로젝트에 추가하거나 CLI를 설치하는 명령은 pip install hlock, uv add hlock, uv tool install hlock, pipx install hlock이다. 설치 없이 실행하려면 uvx hlock --help를 사용할 수 있다. GitHub 저장소에서도 도구를 확인할 수 있다.

hlock pin은 현재 설정을 기록하고, hlock check는 고정한 뒤 달라진 점을 보여준다. hlock sync는 잠금 파일에 기록된 환경을 복원하며, hlock launch와 hlock run은 잠금된 설정으로 세션을 시작하거나 프롬프트를 실행한다. 잠금 파일에는 각 구성 요소의 버전과 다이제스트가 들어간다. API 키와 토큰은 HLOCK_SECRET_* 자리표시자로 바뀌어 잠금 파일에 포함되지 않으며, 동기화할 때 값을 제공해야 한다. 동기화 과정에서 자동으로 처리할 수 없는 항목도 알려준다. hlock launch는 잠금에 맞춘 격리 환경에서 실행해 컴퓨터에 있는 잠금되지 않은 설정을 사용하지 않도록 한다.

팀 저장소에서는 구성원이 각자 설정을 .hlock/locks/harness.<handle>.lock에 저장할 수 있다. 저장소를 복제한 사람은 hlock launch --lock으로 동료의 설정을 자신의 환경과 분리해 시험하거나, 저장소 밖에서 잠금 파일 가져오기를 이용할 수 있다. 팀 저장소의 구성과 명령은 팀 저장소 안내에 나와 있다.

hlock migrate는 잠금 설정을 다른 하네스에 맞게 옮긴다. 예를 들어 Claude Code에서 Codex로 바꿀 때 스킬과 MCP 서버, 지침을 새 하네스가 읽는 위치로 옮기고, 모델은 새 하네스가 지원하는 제공자로 바꾼다. hlock localize는 잠금 설정을 오픈소스 하네스와 Ollama, LM Studio 같은 로컬 실행 환경의 모델에 맞는 구성으로 바꾼다. 평가 팩을 제공하면 로컬 모델 후보를 실제 작업에 대조해 측정할 수 있다.

hlock meta는 설치, 평가 작업 채우기, 구성 요소 업데이트 같은 일을 에이전트에 맡기고 결과를 확인한다. 내장 에이전트나 Pi, Codex, Goose, OpenCode, Hermes를 사용할 수 있으며, API 키 또는 --local 옵션을 통한 오픈 웨이트 모델로 실행한다. 명령마다 확인을 받거나 허용 목록에 따라 --headless로 실행할 수 있다.

에이전트 설정을 재현 가능한 기준선으로 만든 뒤에는 자체 작업을 대상으로 성공률, 비용, 지연 시간을 측정할 수 있다. hlock evals init --from-traces는 기존 요청 기록에서 평가 팩 초안을 만들고, harness.toml에는 시험할 모델과 하네스, ‘최선’을 판단하는 기준을 적는다. hlock resolve는 평가 대상 조합을 측정해 근거와 함께 결과를 잠그며, hlock upgrade는 새 모델을 시험하고 성능이 유지되는 경우에만 채택한다. hlock tune은 평가를 바탕으로 프롬프트와 하이퍼파라미터, 소형 모델을 조정하며 로컬이나 오프라인, Flyte GPU 클러스터 또는 직접 작성한 백엔드에서 실행할 수 있다.

자세한 내용은 설치 안내, 작동 방식, 기존 APM 사용자를 위한 안내, 관련 도구 비교, CLI 참고 문서, Python API에서 볼 수 있다.