CLI 참조
update
apothem update 명령에 대한 CLI 참조.
현재 공유 프로필로부터 하니스 어댑터 구성을 다시 설치합니다.
개요
apothem update --harness NAME|all [--profile PATH] [--dry-run]
[--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]update는 현재 공유 프로필로부터 하니스 출력을 다시 머티리얼라이즈합니다.
install과 같은 프로필 검증, --harness all 선택, 프로젝트 범위 검사, 드라이
런 동작, JSON 봉투를 사용합니다.
홈 디렉터리에 스킬을 쓰는 프로젝트 범위 어댑터의 경우
(install 참조),
update는 그 폴더들도 최신 상태로 맞추고 그 폴더들의 이름을 알려 주는 같은
Note:를 출력합니다. 스킬을 쓰기 전에 설치된 어댑터는 다음 업데이트 때 스킬을
받습니다. Apothem이 쓰지 않은 스킬 폴더는
install에서처럼 경고와 함께
건너뜁니다. 이전에 공유 스킬 폴더를 쓴 설치는 다음 업데이트 때 모든 설치가
공유하는 형태로 다시 쓰입니다. 바뀌는 각 폴더는 먼저 백업됩니다.
연속형 별칭 apothem updating(apothem Updating으로도 받아들여짐)은 같은
핸들러로 해석됩니다.
옵션
| 옵션 | 설명 |
|---|---|
--harness NAME | 업데이트할 하니스 어댑터, 또는 레지스트리 전체 집합을 뜻하는 all(필수). all을 사용하면 프로필의 exclude_harnesses에 나열된 하니스는 건너뛰지만, 명시적으로 이름을 지정한 하니스는 나열되어 있어도 업데이트됩니다. |
--profile PATH | 공유 프로필 YAML 경로. 기본값은 ~/.config/apothem/profile.yaml입니다. |
--dry-run | 파일을 쓰지 않고 업데이트를 미리 봅니다. |
--project PATH | 프로젝트 범위 하니스의 프로젝트 루트. 선택한 하니스 집합에 프로젝트 범위 어댑터가 포함되면 필수입니다. |
--quiet, -q | 정보성 출력을 억제합니다. 오류만 출력됩니다. |
--verbose, -v | 추가 진단 출력을 내보냅니다. |
--format plain|json | 출력 형식(기본값: plain). |
--json | --format json의 축약형. |
--no-color | 출력에서 ANSI 색상 코드를 비활성화합니다. |
-h, --help | 도움말을 표시하고 종료합니다. |
JSON 출력
{
"schema_version": 1,
"status": "success",
"command": "update",
"action": "updated",
"harness": "claude-code",
"profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
"project": null,
"files_written": [],
"results": [],
"warnings": [],
"error": null,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}--dry-run은 status: "dry_run"과 files_written: []를 반환합니다.
예제
apothem update --harness claude-code
apothem update --harness claude-code --dry-run
apothem update --harness all --project . --dry-run --json
apothem Updating --harness claude-code # continuous-form alias
apothem updating --harness claude-code # lowercase variant종료 코드
| 코드 | 의미 |
|---|---|
| 0 | 어댑터가 성공적으로 업데이트되었거나 드라이 런이 문제없이 계획됨 |
| 1 | 예상된 검증, 프로필, 하니스, 프로젝트, 또는 어댑터 오류 |
| 2 | 적어도 한 번 쓴 뒤에 발생한 부분적인 일괄 머티리얼라이즈 |
| 64 | 사용법 오류: 알 수 없는 옵션이나 명령, 또는 누락되었거나 잘못된 옵션 값. --json에서는 오류가 코드 cli.usage를 담은 JSON 봉투로 반환됩니다. |
함께 보기
apothem updating— 이 명령의 연속형 별칭(여기에 문서화됨. CLI는 두 형식을 모두 받음)- apothem install — 최초 설치
- 업데이트 가이드 — 설치 프로그램별 업데이트 경로