뒤로가기
← 전체 기능

설치·운영v0.3.0에서 사용 가능

oah와 구성 요소 업그레이드

업그레이드 문서는 부분마다 업데이트 방법을 알려 준다. oah 자체(pull한 뒤 --skip-tools로 설치 프로그램을 다시 실행하거나 검증한 릴리스 압축 파일 사용), oah init이 쓴 파일(oah rules check와 oah rules sync), 스킬 키트 캐시와 프로젝트 고정본, unlazy, MCP 템플릿 고정 버전, 모델이다. 먼저 열린 리스를 끝내거나 내려놓는다.

필요한 상황

모델, 스킬, 도구는 계속 바뀐다. 부분마다 업데이트할 분명한 방법이 없으면 하네스가 뒤처지거나 업데이트가 몰래 하네스를 깨뜨린다.

동작 방식

  1. 클론에서는 git pull 뒤 bash install/install.sh --skip-tools(Windows는 -SkipTools)를 실행하고, 새 터미널에서 oah --version과 oah doctor를 실행한다.
  2. 프로젝트마다 oah rules check는 AGENTS.md의 관리 블록이 다른지 읽기만 하고 알려 주고, oah rules sync는 그 블록만 바꾸며, oah init은 빠진 것만 쓰고, oah models --refresh는 모델 목록을 다시 읽는다.
  3. 스킬은 키트 캐시는 oah skills update나 자동 확인으로, 프로젝트 사본은 oah skills update --project로만, 사용자 폴더는 먼저 묻는 --global로만 바뀐다.
  4. unlazy는 고정돼 있고 새 oah 버전만 고정을 옮긴다. OAH_UNLAZY_UNPINNED를 고치려면 OAH_UNLAZY_DIR을 고치거나 지우고, 맞지 않는 프로젝트 사본을 옮겨 둔 뒤 oah init --with-unlazy를 다시 실행한다.
  5. MCP 템플릿에서 OAH_MCP_UPDATE_AVAILABLE은 새 npm 버전이 있다는 뜻이지 설치됐다는 뜻이 아니다. 자기 설정의 @<version> 부분을 고치고 Claude Code나 Codex를 다시 시작한다.
  6. docs/UPSTREAM_SYNC.md는 만든 사람의 하네스에서 어떤 변경을 옮기고, 건너뛰고, 미뤘는지 기록한다. 그 개선은 평범한 oah 릴리스로 받는다.

예제

macOS에서 클론으로 oah를 업데이트한다(업그레이드 문서).

cd open-agent-harness
git pull
bash install/install.sh --skip-tools

요구 사항

  • 열린 리스가 없어야 한다. oah status가 목록을 보여 주며, 리스가 하나라도 열려 있으면 스킬 업데이트는 기다린다.

한계와 복구

  • 어떤 업데이트 명령도 MCP 고정 버전이나 MCP 설정을 고치지 않는다.
  • unused(offline)이나 unused(registry error)는 버전 확인이 답을 얻지 못했다는 뜻이다. 나중에 다시 시도한다.
  • 문서의 모델 부분은 아직 릴리스하지 않은 main을 설명한다.
  • 만든 사람의 하네스에서 복사해 오는 것은 없고, 실행할 때 그 하네스에 의존하지도 않는다.

원문 문서

관련 기능