macOS 업데이트 및 제거

이 페이지에서는 macOS에 Revka를 설치한 이후의 운영 주기를 다룹니다. 구체적으로는 Revka를 현재 위치에서 업데이트하는 방법과 깔끔하게 제거하는 방법을 설명합니다. 최초 설치는 설치를 참고하세요.

사용할 명령어는 설치 방식에 따라 다릅니다. Homebrew, 부트스트랩 스크립트(install.sh), Cargo, 수동 사전 빌드 다운로드 각각 업데이트 및 제거 경로가 다르므로, 먼저 현재 활성화된 설치 방식을 확인하세요.

설치 방식 확인

다음 두 명령어로 셸에서 실행되는 revka 바이너리의 위치와 버전을 확인할 수 있습니다.

which revka
revka --version

macOS에서의 일반적인 바이너리 위치:

설치 방식	바이너리 경로
Homebrew (Apple Silicon)	/opt/homebrew/bin/revka
Homebrew (Intel)	/usr/local/bin/revka
Cargo / 부트스트랩 / 수동	~/.cargo/bin/revka

참고

Homebrew와 Cargo 설치는 동일한 머신에 공존할 수 있습니다. 둘 다 존재하는 경우 PATH 순서에 따라 실행되는 바이너리가 결정됩니다. 업데이트 또는 제거 전에 which revka를 실행하여 현재 활성 바이너리를 확인하고, 원하는 바이너리가 우선순위를 갖도록 PATH를 구성하세요.

업데이트

현재 설치 방식에 해당하는 섹션을 선택하세요. 업데이트 후에는 revka --version으로 결과를 확인하세요.

Homebrew

brew update
brew upgrade revka
revka --version

팁

Homebrew로 설치한 경우, Revka의 런타임 데이터는 ~/.revka가 아닌 Homebrew의 var 디렉토리(<brew_prefix>/var/revka/)에 저장됩니다. 서비스 로그는 <brew_prefix>/var/revka/logs/에 위치하며, launchd 서비스는 해당 경로를 가리키도록 REVKA_CONFIG_DIR을 설정합니다. 따라서 brew upgrade를 실행해도 설정 파일과 워크스페이스 데이터는 유지되므로, 업그레이드 전에 별도로 백업할 필요가 없습니다.

Clone + 부트스트랩 설치

로컬 저장소 체크아웃에서 설치한 경우, 최신 소스를 가져온 후 설치 스크립트를 다시 실행하세요. --prefer-prebuilt 플래그를 사용하면 최신 릴리스 바이너리를 우선 다운로드하고, 사전 빌드 파일이 없을 때만 소스 빌드로 대체합니다.

git pull --ff-only
./install.sh --prefer-prebuilt
revka --version

체크아웃에서 소스 빌드만 강제로 수행하려면 다음 명령어를 사용하세요.

git pull --ff-only
cargo install --path . --force --locked
revka --version

Cargo 설치

Cargo를 통해 ~/.cargo/bin에 바이너리를 설치한 경우, 위에서 제시한 동일한 cargo install --path . --force --locked 명령어로 체크아웃에서 바이너리를 재빌드하여 교체하세요.

자체 업데이트 (revka update)

모든 설치 방식에서 내장 자체 업데이터를 사용할 수도 있습니다. 이 업데이터는 GitHub Releases에서 릴리스 바이너리를 다운로드하고, SHA256 및 선택적 cosign 서명을 검증한 후, 현재 바이너리를 백업하고 새 바이너리로 교체하며, 스모크 테스트를 실행합니다. 새 바이너리가 실패할 경우 자동으로 롤백됩니다.

revka update            # download and install the latest release
revka update --check    # check for a newer version without installing
revka update --force    # skip the confirmation prompt
revka update --version X.Y.Z   # install a specific version

플래그	설명
--check	확인만 수행하고 업데이트 가능 여부를 보고합니다. 설치는 진행하지 않습니다.
--force	대화형 확인 프롬프트를 건너뜁니다.
--version <X.Y.Z>	최신 버전 대신 특정 릴리스를 대상으로 합니다.

주의

revka update는 현재 경로의 바이너리를 교체합니다. Homebrew로 설치한 경우에는 Homebrew의 패키지 메타데이터와 설치된 바이너리가 일관되게 유지되도록 brew upgrade revka를 사용하는 것이 좋습니다.

수동 사전 빌드 바이너리

릴리스 바이너리를 직접 다운로드하여 설치한 경우, 최신 릴리스 파일로 다운로드 및 설치 과정을 다시 수행한 후 확인하세요.

revka --version

제거

제거는 세 단계로 구성됩니다. 백그라운드 서비스를 중지하고, 바이너리를 삭제한 후, 선택적으로 로컬 런타임 데이터를 삭제합니다.

1. 백그라운드 서비스 중지 및 제거

바이너리가 삭제된 후에도 launchd 관리 데몬이 계속 실행되지 않도록 이 단계를 먼저 수행하세요.

revka service stop || true
revka service uninstall || true

macOS에서 revka service uninstall은 생성된 launchd 에이전트를 제거합니다.

• ~/Library/LaunchAgents/com.revka.daemon.plist

참고

brew services start revka로 Revka를 시작한 경우에도 동일한 launchd plist가 사용됩니다. revka service uninstall로 제거할 수 있으며, brew services list로 확인할 수 있습니다.

2. 바이너리 제거

Homebrew:

brew uninstall revka

Cargo / 부트스트랩 / 수동 (~/.cargo/bin/revka의 바이너리):

cargo uninstall revka || true
rm -f ~/.cargo/bin/revka

주의

Homebrew와 Cargo 양쪽에 모두 설치되어 있는 경우, 두 가지 제거 방법을 모두 실행하세요. 각 단계 사이에 which revka를 실행하여 바이너리가 제대로 삭제되었는지 확인하세요.

3. (선택 사항) 로컬 런타임 데이터 삭제

이 단계는 설정, 인증 프로필, 로그, 워크스페이스 상태를 모두 삭제합니다. 완전한 정리가 필요할 때만 실행하세요. 되돌릴 수 없습니다.

rm -rf ~/.revka

주의

Homebrew로 설치한 경우, 런타임 데이터는 ~/.revka가 아닌 <brew_prefix>/var/revka/에 저장됩니다. brew uninstall revka를 실행해도 해당 디렉토리가 남아 있을 수 있습니다. Homebrew 설치를 완전히 정리하려면 Homebrew var 디렉토리도 함께 삭제하세요. 예를 들어 rm -rf "$(brew --prefix)/var/revka"를 실행하면 됩니다.

제거 확인

바이너리가 삭제되었고 실행 중인 프로세스가 없는지 확인하세요.

command -v revka || echo "revka binary not found"
pgrep -fl revka || echo "No running revka process"

pgrep에서 여전히 프로세스가 보고되면 수동으로 중지한 후 다시 확인하세요.

pkill -f revka

관련 페이지

• 설치 — macOS, Linux, Windows 및 컨테이너에서의 최초 설치.
• Python MCP 사이드카 설치 — ~/.revka 아래에 위치하는 Kumiho 및 Operator 사이드카.
• revka install, update, migrate, completions & ACP — 라이프사이클 CLI 명령어 전체 레퍼런스.
• 백그라운드 서비스로 실행 — launchd 서비스 설치, 시작, 중지 및 로그.
• 업데이트, 런북 및 문제 해결 — 크로스 플랫폼 업데이트 및 롤백 가이드.