CLI 레퍼런스

apothem CLI는 공유 프로필과 하니스 어댑터를 관리하는 주된 운영자 인터페이스입니다.

전역 플래그

플래그	설명
`--version`	Apothem 버전을 출력하고 종료합니다
`--help`	명령의 도움말을 출력합니다

하위 명령

`apothem install`

공유 프로필에서 하니스 어댑터를 설치합니다.

apothem install --harness <name|all> [--profile PATH] [--project PATH] [--dry-run]

옵션	설명
`--harness <name>`	하니스 어댑터 이름(아래의 정규 값 참조). 필수.
`--profile PATH`	공유 프로필 YAML 경로. 기본값은 `~/.config/apothem/profile.yaml`.
`--project PATH`	프로젝트 범위 하니스를 위한 프로젝트 루트.
`--dry-run`	파일을 쓰지 않고 설치를 미리 봅니다.

정규 --harness 값:

antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
hermes
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed

레지스트리 전체 집합을 선택하려면 --harness all --project <path>를 사용하세요. 프로필의 exclude_harnesses 목록은 설치/업데이트 배치 선택 중에 존중됩니다.

`apothem update`

현재 공유 프로필에서 하니스 어댑터의 네이티브 구성을 다시 파생합니다.

apothem update --harness <name|all> [--profile PATH] [--project PATH] [--dry-run]

옵션	설명
`--harness <name>`	하니스 어댑터 이름. 필수.
`--profile PATH`	공유 프로필 YAML 경로.
`--project PATH`	프로젝트 범위 하니스를 위한 프로젝트 루트.
`--dry-run`	파일을 쓰지 않고 업데이트를 미리 봅니다.

update는 하니스 출력을 다시 구체화합니다. Apothem CLI 패키지 자체는 업데이트하지 않습니다. 패키지 업그레이드에는 Apothem을 설치한 패키지 관리자를 사용하세요.

`apothem uninstall`

하니스 어댑터의 네이티브 구성을 제거합니다.

apothem uninstall --harness <name|all> [--project PATH] [--yes]

옵션	설명
`--harness <name>`	하니스 어댑터 이름. 필수.
`--project PATH`	프로젝트 범위 하니스를 위한 프로젝트 루트.
`--yes`	확인 프롬프트를 건너뜁니다.

`apothem verify`

하니스 어댑터가 설치되어 있고 그 출력 경로가 존재하는지 검증합니다.

apothem verify --harness <name|all> [--project PATH]

옵션	설명
`--harness <name>`	하니스 어댑터 이름 또는 `all`. 필수.
`--project PATH`	프로젝트 범위 하니스를 위한 프로젝트 루트.

어댑터가 설치되어 있으면 종료 코드는 0, 그렇지 않으면 1입니다.

`apothem profile`

공유 Apothem 프로필을 관리합니다.

apothem profile show [--profile PATH]
apothem profile init [--profile PATH] [--force]
apothem profile set <key> <value> [--profile PATH]
apothem profile edit [--profile PATH]

하위 명령	설명
`profile init`	스키마에 유효한 최소 프로필 스캐폴드를 생성합니다.
`profile show`	해석된 프로필(YAML)을 stdout에 출력합니다.
`profile set <key> <value>`	프로필 필드를 설정합니다. 값은 YAML로 파싱됩니다(문자열, 숫자, 불리언, 리스트, 매핑이 모두 허용됩니다).
`profile edit`	`$EDITOR`에서 프로필을 엽니다(플랫폼 기본 에디터로 폴백합니다).

--profile PATH 옵션은 각 하위 명령을 대체 프로필 파일로 향하게 합니다. 기본값은 ~/.config/apothem/profile.yaml.

`apothem harnesses`

등록된 하니스 어댑터를 나열하고 검사합니다.

apothem harnesses list
apothem harnesses show <name>

하위 명령	설명
`harnesses list`	등록된 각 어댑터를 설치 상태 플래그 및 출력 경로와 함께 표로 출력합니다.
`harnesses show <name>`	한 어댑터의 이름, 설치 상태, 출력 경로를 출력합니다.

`apothem doctor`

Apothem 설치에 대한 시스템 진단을 실행합니다.

apothem doctor

Apothem 버전, Python 인터프리터, 플랫폼, 해석된 프로필 경로, 그리고 하니스별 설치 상태 표를 출력합니다. 등록된 모든 어댑터가 설치됨을 보고하면 종료 코드는 0, 그렇지 않으면 1입니다.

생성된 명령 및 플래그 레퍼런스

Command	Flags	Description
`apothem completion`	—	Print a shell-completion script for SHELL to stdout. Supported shells: bash, zsh, fish, powershell. Every script is generated by Click's env-var completion protocol — PowerShell through the completion class registered above, since Click ships none natively. Enabling completion is opt-in: this command only prints the script — pipe or append it to the shell's completion file yourself (see `--help`).
`apothem diff`	`--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Preview the pending configuration changes for a single harness.
`apothem doctor`	`--format`, `--json`, `--no-color`, `--quiet, -q`, `--verbose, -v`	Report Apothem environment and installation health, exiting non-zero on any failure. Prints the engine version, Python, and platform, validates the shared profile against the packaged schema — a present-but-malformed profile is a failure, not a green "found" — and probes every registered adapter's install state. An adapter that raises degrades to an error row rather than aborting the sweep. Any failed check — an invalid profile, or a harness that is uninstalled or could not be probed — forces a non-zero exit so a CI or setup step can gate on it.
`apothem harnesses list`	`--format`, `--json`, `--no-color`, `--quiet, -q`, `--verbose, -v`	List all registered harness adapters.
`apothem harnesses show`	`--format`, `--json`, `--no-color`, `--quiet, -q`, `--verbose, -v`	Show details for a specific harness adapter.
`apothem install`	`--clean, --fresh`, `--dry-run`, `--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Install a harness adapter configuration.
`apothem migrate-workspace`	`--dry-run`, `--format`, `--json`, `--no-color`, `--project`, `--quiet, -q`, `--verbose, -v`	Migrate a legacy per-harness workspace into the shared `.apothem` layout. The base is the resolved `--project` root when supplied, otherwise the current working directory (the project-local default). Per-harness memory/contexts/learning stores union-merge into the shared store; a conflicting record is skipped, never overwritten; a legacy `.plans` tree moves under `.apothem/plans`; every consumed source is backed up first. The migration is idempotent.
`apothem profile edit`	`--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Open the shared profile in the system editor.
`apothem profile init`	`--force`, `--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Create a schema-valid shared profile scaffold.
`apothem profile set`	`--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Set a key in the shared profile. KEY is a dotted path that descends into the nested profile structure (`identity.name`, `preferences.style`, `enforcement.sprints`, `harnesses.<harness>.preferences.style`); a single key with no dot sets a top-level node. VALUE is stored as a literal string — bare words are not coerced (`no` stays `"no"`, `2024-01-01` and `1.0` stay strings) — except `true`/`false` (the boolean enforcement flags) and explicit `[...]`/`{...}` list/map input. The fully-assembled profile is validated against the packaged schema BEFORE writing; an invalid set is refused with the standard diagnostic and the profile on disk is unchanged.
`apothem profile show`	`--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Display the current shared profile.
`apothem quickstart`	`--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Guided first run: ensure a profile, preview the writes, then install. Walks a new operator through the canonical path in one linear flow — create a starter profile if none exists (with a personalize nudge), preview the files each harness will write (project root vs your home directory), confirm, then install with the grouped capability-note output — and ends with the recommended next commands. `--yes` runs the whole sequence non-interactively; `--format json` emits one structured summary of every step. It composes the install building blocks; it does not duplicate them.
`apothem rollback`	`--format`, `--harness`, `--install-id`, `--json`, `--last`, `--no-color`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Restore a harness to the state before its recorded install.
`apothem status`	`--format`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Report install, verify, and drift state for every registered harness.
`apothem uninstall`	`--format`, `--harness`, `--json`, `--no-color`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Remove a harness adapter configuration.
`apothem update`	`--dry-run`, `--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Re-install a harness adapter configuration from the current profile.
`apothem verify`	`--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Verify a harness adapter installation. Without `--profile` the check is structural: every managed target must be present and valid. With `--profile` the check additionally requires profile fidelity, so a present-but-drifted install fails verify — answering "is THIS profile faithfully installed?" rather than merely "does it exist?".

CLI 레퍼런스

On this page