cli

# Opaline CLI Opaline CLI는 Claude Code 및 OpenAI Codex 세션을 캡처하여 팀 분석을 위해 Opaline 플랫폼에 업로드하는 명령줄 도구입니다. 프로덕션 API는 `https://opaline.so`에서 호스팅됩니다. 이전에는 `rudel`로 알려졌으며 해당 이름과의 호환성을 유지합니다. ## 빠른 시작 Node.js 20 이상이 필요합니다.任意 디렉토리에서 `npx opaline@latest`를 실행하세요. CLI는 로컬 Claude Code 및 Codex 세션을 스캔하고, 저장소 및 세션 수를 표시하며, 업로드 및 동기화를 유지할 저장소를 선택할 수 있게 합니다. 로그인은 선택 후에만 열립니다. `pnpx opaline@latest`도 작동하며, 전역 설치는 선택 사항입니다. Opaline 데모에서 명령을 복사하면 숨겨진 `--code` 값이 추가됩니다. 이 일회성 코드는 실시간 선택 및 업로드 상태를 위해 터미널을 브라우저와 연결합니다. 사용하지 않으면 10분 후에 만료됩니다. 명령을 복사한 동일한 브라우저에서 로그인을 승인하세요. 첫 업로드는 브라우저 설정을 계속 진행하며, 기존 사용자는 작업 공간 세션 페이지를 엽니다. 자동 업로드는 번들된 CLI를 `~/.rudel/runtime`에 유지하고 Node 실행 파일을 사용하므로 임시 러너 캐시가 사라진 후에도 후크가 계속 작동합니다. `opaline login`은 브라우저 기반 장치 흐름을 엽니다. `opaline upload`는 로컬 작업 트리를 저장소별로 그룹화하고, 동기화 상태를 유지할 저장소를 선택할 수 있게 하며, 필요한 Claude Code 및/또는 Codex 후크를 설치하고 새 세션을 업로드합니다. 동일한 테이블을 열어 저장소를 ON 또는 OFF로 전환할 수 있습니다. 기존 `rudel` 사용자는 다시 로그인할 필요가 없습니다. Opaline은 의도적으로 기존 `~/.rudel` 자격 증명 및 상태 디렉토리를 읽으며, `rudel` 패키지는 호환성 별칭으로 계속 제공됩니다. 홈 폴더를 포함한任意 디렉토리에서 `opaline upload`를 실행하세요. 선택기는 여러 저장소에서 저장된 세션을 찾아 선택한 저장소를 업로드합니다. 또한 해당 선택 항목에 대해 자동 업로드를 활성화합니다. Claude Code의 후크는 사용자 설정에 설치되므로 설정은 현재 디렉토리에 의존하지 않습니다. 기존 후크 및 설정은 보존됩니다. ## 일반적인 워크플로우 `opaline upload`(또는 `npx opaline@latest`)를 실행하여 저장소 테이블을 엽니다. 테이블은 스캔 중에 채워지며, 로컬 및 이미 업로드된 세션 수와 ON/OFF 토글이 표시됩니다. 스페이스는 저장소를 변경하고, Enter는 새로 추가된, 이미 활성화된, 비활성화된 저장소가 포함된 검토를 엽니다. Enter는 확인하고, Esc는 편집으로 돌아갑니다. 업로드 진행 상황은 동일한 테이블에 유지됩니다. 기존 Rudel 후크는 활성화된 것으로 인식됩니다. 저장하면 소유한 후크가 Opaline으로 마이그레이션되고, 중복 로컬 후크가 제거되며, 관련 없는 에이전트 설정이 보존됩니다. Codex 알림 도구는 자동 업로드와 공존할 수 있습니다. Opaline은 기존 명령 및 인수를 유지하고, 알림 JSON을 전달하며, 독립적으로 업로드합니다. Codex Computer Use는 알림 체인의 앞쪽에 유지됩니다. 업로드를 OFF로 전환해도 알림은 계속 작동합니다. 사용자 지정 스크립트는 보존되며, Opaline은 이전 Rudel 설치를 직접 호출하는 스크립트를 다시 작성하지 않습니다. 설정 실패는 전체 세부 정보와 재시도/뒤로 작업을 표시하며, Codex 구성이 유효하지 않은 경우 수정할 설정 파일도 포함합니다. ## 주요 개념 - **세션:** 로컬 머신에서 발견된 Claude Code 및 Codex JSONL 트랜스크립트. - **후크:** `opaline upload` 또는 `opaline enable`로 설치된 에이전트 수명 주기 명령. 후크는 헤드리스로 실행되고, 저장소 허용 목록을 참조하며, 알려진 비밀 패턴을 필터링하고, 완료된 세션을 업로드합니다. - **조직:** 업로드를 수신하는 Opaline 작업 공간. `opaline set-org`를 사용하여 프로젝트와 연결된 조직을 변경합니다. - **로컬 상태:** 자격 증명, 재시도 큐, 로그 및 프로젝트 매핑은 호환성을 위해 `~/.rudel`에 유지됩니다. `OPALINE_CONFIG_DIR`을 설정하여 다른 디렉토리를 선택할 수 있으며, `RUDEL_CONFIG_DIR`도 계속 지원됩니다. - **호환성 별칭:** `rudel` 실행 파일은 인수, 표준 입력/출력 및 종료 상태를 변경하지 않고 동일한 Opaline 구현에 위임합니다. 유일한 추가 사항은 호출당 stderr에 한 번의 이름 변경 알림입니다.