v1.3.0 복구 무결성과 상류 감시 강화

무엇을 위한 업데이트인가

Orca 앱을 정상 제거한 뒤에도 AI 에이전트와 시스템에 남아 있는 Orca 스킬·훅·CLI·설정·캐시를 찾아, 검증 가능한 백업으로 격리하고 안전하게 복원하는 도구입니다. Orca 앱 본체는 제거하지 않습니다.

주요 변경사항

• 정리 시작 전부터 기록하는 manifest v2 작업 저널을 도입해 중단된 정리도 복구할 수 있습니다.
• verify 명령으로 백업의 SHA-256 무결성과 복원 가능성을 실제 복원 전에 검사합니다.
• 기본 백업 경로를 매 실행마다 고유하게 만들고, 비어 있지 않거나 정리 대상 내부인 백업 경로를 사전에 거부합니다.
• 백업 변조가 감지되면 복원을 중단하며, 기존 manifest v1 복원 호환성을 유지합니다.
• Linux AppImage 캐시와 서명이 확인된 Codex 플러그인 캐시의 Orca 스킬을 추가 탐지합니다.
• 공식 Orca 최신 릴리스와 설치 계약의 변경을 매일 감시하고 변경 시 GitHub Issue를 생성합니다.
• CodeQL 분석과 비공개 취약점 신고를 활성화했습니다.
• Windows, macOS, Ubuntu × Node.js 18, 22, 24 및 Windows PowerShell 테스트를 통과했습니다.

권장 사용 순서

1. 운영체제의 정상 제거 기능으로 Orca 앱을 먼저 제거합니다.
2. Claude, Codex 등 관련 에이전트를 종료합니다.
3. scan과 clean --dry-run으로 대상을 확인합니다.
4. clean으로 격리한 뒤 verify로 백업 무결성을 확인합니다.
5. 문제가 있으면 manifest.json을 지정해 restore를 실행합니다.

주의

기본 정리는 확인된 Orca 잔재만 백업 폴더로 격리합니다. OpenAI 공식 computer-use, 다른 공급자의 스킬과 사용자 프로젝트 코드는 자동으로 제거하지 않습니다.

v1.2.0 안전 복원과 잔재 탐지 강화

무엇을 위한 업데이트인가

Orca 앱을 정상 제거한 뒤에도 AI 에이전트와 시스템에 남아 있는 Orca 스킬·훅·CLI·설정·캐시를 찾아 복구 가능하게 격리하는 도구입니다. Orca 앱 본체는 제거하지 않습니다.

주요 변경사항

• restore 명령을 추가해 정리 전 상태로 복원할 수 있습니다.
• manifest의 SHA-256 무결성, 운영체제, 백업 루트와 대상·백업 매핑을 검증합니다.
• 복원 위치에 새 파일이 있으면 덮어쓰기 전에 restore-conflicts에 보존합니다.
• WSL, SSH 원격 홈, 사용자 전체 ~/.orca, 프로젝트별 .orca 잔재를 선택적으로 정리합니다.
• 최신 Orca 공식 설치·스킬 경로와 중단된 설치 트랜잭션 잔재를 탐지합니다.
• macOS 대소문자 비구분 경로의 중복 처리를 방지합니다.
• Windows 사용자 PATH 복원을 지원합니다.
• Windows, macOS, Ubuntu와 Node.js 18·22 조합의 CI를 통과했습니다.

안전한 사용 순서

1. 운영체제의 정상 제거 기능으로 Orca 앱을 먼저 제거합니다.
2. Claude, Codex 등 관련 에이전트를 종료합니다.
3. scan과 clean --dry-run으로 대상을 확인합니다.
4. 실제 정리 후 문제가 있으면 생성된 manifest.json으로 복원합니다.

node scripts/orca-agent-cleanup.mjs scan
node scripts/orca-agent-cleanup.mjs clean --dry-run --include-app-data --include-voice-data
node scripts/orca-agent-cleanup.mjs clean --include-app-data --include-voice-data
node scripts/orca-agent-cleanup.mjs restore --dry-run --manifest /path/to/manifest.json
node scripts/orca-agent-cleanup.mjs restore --manifest /path/to/manifest.json

주의

기본 정리는 확인된 Orca 잔재만 백업 폴더로 격리합니다. OpenAI 공식 computer-use, 다른 공급자의 스킬과 사용자 프로젝트 코드는 자동으로 제거하지 않습니다.

v1.1.0 Linux 지원과 최신 Orca 스킬 경로

무엇을 위한 업데이트인가

Orca 앱을 제거한 뒤 에이전트 홈에 남는 스킬·훅·CLI 잔재를 정리하는 도구입니다. 이번 버전은 2026-08-07 Windows·macOS 공개본 이후 Orca 공식 설치 경로를 다시 맞춰 올렸습니다.

달라진 점

• Linux 지원. orca-ide와 Orca가 만든 dispatcher만 치우고, GNOME 스크린 리더 /usr/bin/orca는 건드리지 않습니다.
• 홈 스킬 경로 추가: Hermes, Prime Agent, Droid(.factory), Continue, Trae, Augment
• --project로 프로젝트 안 .factory, .continue, .trae, .grok, .augment 스킬도 검사합니다.
• Linux 앱 데이터 ~/.config/Orca, ~/.cache/Orca는 --include-app-data일 때 포함합니다.
• CI에 Ubuntu를 추가했습니다.

그대로인 점

• 기본 명령은 scan입니다. 확인된 항목만 백업 폴더로 옮깁니다.
• OpenAI computer-use, 다른 공급자 스킬, 사용자 프로젝트 코드는 지우지 않습니다.

사용

git clone https://github.com/wilgon456/orca-agent-cleanup.git
cd orca-agent-cleanup
node scripts/orca-agent-cleanup.mjs scan
node scripts/orca-agent-cleanup.mjs clean --dry-run --include-app-data --include-voice-data