설치 방법

0준비물

• 초대받은 이메일 주소
• macOS: Apple Silicon(M1 이후)은 darwin-arm64, Intel은 darwin-x64 파일을 받아요. 사과 메뉴 → 이 Mac에 관하여에서 칩을 확인할 수 있어요.
• 터미널(응용 프로그램 → 유틸리티)
• Chrome: 크롬 익스텐션을 쓸 때만(선택)

Windows·Linux는 아직 확인하지 않았어요. 실제로 확인한 것은 Apple Silicon Mac이에요.

1웹 로그인

1. 앱 열기를 눌러 app.oxhee.com으로 가요.
2. 초대받은 이메일을 넣어요.
3. 메일로 온 1회용 코드(PIN)를 넣으면 옥희 화면이 열려요. 한 번 로그인하면 일주일 동안 유지돼요.

여기까지면 목록·지도·할인율·매각기일을 볼 수 있어요. 휴대폰에서도 같아요.

2설치본 받기

파일 이름은 oxhee-alpha-0.2.0-alpha.1-darwin-arm64.tar.gz(Apple Silicon) 또는 oxhee-alpha-0.2.0-alpha.1-darwin-x64.tar.gz(Intel)예요. 체크섬 파일 SHA256SUMS가 함께 와요.

설치본은 이 압축 파일 하나에 웹 화면·로컬 데몬(oxheed)·크롬 익스텐션이 모두 들어 있어요.

3설치

받은 파일이 있는 폴더에서 터미널을 열고 실행해요.

tar -xzf oxhee-alpha-0.2.0-alpha.1-darwin-arm64.tar.gz
cd oxhee-alpha-0.2.0-alpha.1-darwin-arm64
bash install.sh            # 직접 실행 방식(기본)

bash install.sh --launchd  # 로그인할 때 자동으로 뜨게 등록

tar -xzf oxhee-alpha-0.2.0-alpha.1-darwin-x64.tar.gz
cd oxhee-alpha-0.2.0-alpha.1-darwin-x64
bash install.sh            # 직접 실행 방식(기본)

bash install.sh --launchd  # 로그인할 때 자동으로 뜨게 등록

install.sh가 하는 일

1. SHA256SUMS로 모든 파일의 체크섬을 확인해요. 하나라도 다르면 멈춰요.
2. ~/.oxhee/bin/oxheed와 ~/.oxhee/bin/web/에 복사하고, 익스텐션을 ~/.oxhee/extension/에 풀어요.
3. 받은 파일에 붙은 격리 표시(quarantine)를 지우고 이 PC에서 실행할 수 있게 서명해요(ad-hoc).
4. --launchd면 자동 실행을 등록하고, oxheed가 응답하면 브라우저를 열어요.

install.sh는 네트워크를 쓰지 않아요.

4실행·첫 수집

~/.oxhee/bin/oxheed serve

브라우저에서 http://127.0.0.1:8765 를 열어요. 끄려면 터미널에서 Ctrl-C.

화면을 이 PC의 oxheed가 직접 띄우므로 “내 PC 연결”은 자동이에요(토큰을 넣지 않아도 돼요).

처음에는 목록이 비어 있어요. “아직 수집한 지역이 없어요” 카드의 내 지역 수집하기를 누르고, 시트에서 지역을 고른 뒤 수집 시작을 누르세요.

지역 하나에 법원 요청 약 10건, 요청 간격 1.8초예요. 진행 상황은 시트에, 보낸 요청은 설정 화면의 “이 PC에서 법원에 보낸 요청”에 남아요.

분석을 쓰려면 PC에서 oxheed llm set으로 모델을 정해요. 아직 정하지 않았으면 사건 화면이 정하는 명령을 알려 줘요.

5웹 앱과 연결 선택

app.oxhee.com(휴대폰 말고 이 Mac의 브라우저)에서 사진·상세·분석까지 쓰려면 이 Mac의 oxheed와 연결해요. 127.0.0.1:8765로만 쓸 거면 건너뛰어도 돼요.

1. oxheed가 app.oxhee.com의 요청을 받도록 허용해 실행해요.

~/.oxhee/bin/oxheed serve --allow-origin https://app.oxhee.com

install.sh --launchd로 자동 실행을 켰다면, 자동으로 뜨는 oxheed는 app.oxhee.com을 허용하지 않아요. 먼저 ~/.oxhee/bin/oxheed uninstall로 등록을 지운 뒤 위 명령으로 실행해요.

2. 다른 터미널 창에서 연결 문자열을 봐요. oxhee://pair?host=127.0.0.1:8765&… 로 시작하는 줄 전체를 복사해요.

~/.oxhee/bin/oxheed pair --show

3. app.oxhee.com의 내 PC · 설정에서 연결 문자열 칸에 붙여 넣고 연결 검사 후 저장을 누르세요.
4. 브라우저가 로컬 네트워크 접근 허용을 물으면 허용을 누르고 다시 검사하세요.

주소와 토큰은 그 브라우저에만 저장돼요. 휴대폰 등 다른 기기에서 내 PC에 붙는 것은 이번 알파 범위가 아니에요.

6크롬 익스텐션 선택

법원경매정보 사건 화면 옆에 분석 패널을 띄워요. 스토어에 올리지 않았으므로 직접 로드해요.

1. 크롬 주소창에 chrome://extensions → 오른쪽 위 개발자 모드 켜기.
2. 압축 해제된 확장 프로그램을 로드합니다 → ~/.oxhee/extension 폴더 선택. (Finder에서 숨김 폴더가 안 보이면 Cmd+Shift+.)
3. 터미널에서 연결 문자열을 복사해 익스텐션 옵션 화면에 붙여 넣어요.

~/.oxhee/bin/oxheed pair --show

연결 문자열의 1회용 등록 토큰은 30분 동안만 유효해요.

7피드백

자동으로 보내는 것은 없어요. 문제가 있으면 아래를 직접 골라 hello@oxhee.com으로 보내 주세요.

• 무엇을 눌렀고 무엇이 이상했는지, 화면 캡처
• 아래 명령의 출력

~/.oxhee/bin/oxheed status --requests 50

• 필요하면 요청 로그 ~/.oxhee/logs/requests.jsonl (법원에 보낸 요청의 시각·경로·결과만, 성명·쿠키 없음)
• --launchd로 띄웠다면 ~/.oxhee/logs/oxheed.err.log

설정 화면(http://127.0.0.1:8765/settings)의 “버전 · 알파 피드백”에 이 PC의 실제 경로와 버전이 나와요.

8삭제

압축을 푼 폴더(oxhee-alpha-0.2.0-alpha.1-darwin-…)에서 실행해요.

bash uninstall.sh          # 프로그램만 지우고 수집한 데이터(~/.oxhee)는 남긴다

bash uninstall.sh --purge  # ~/.oxhee 전체 삭제(스냅샷·캐시·사진·분석·요청 로그·페어링·LLM 설정)

크롬 익스텐션은 chrome://extensions에서 직접 삭제해요.

알려진 제한

• 휴대폰 등 다른 기기에서 내 PC(oxheed)에 접속할 수 없어요(이 PC의 127.0.0.1 전용). 휴대폰은 웹으로 둘러보기만 돼요.
• macOS 외(Windows·Linux)는 확인하지 않았어요. Intel Mac(darwin-x64)은 빌드만 했고 실측하지 않았어요.
• 익스텐션은 수동 로드예요(스토어 미등록). 업데이트도 새 압축 파일로 다시 설치해요.
• 이 PC의 다른 사용자 계정에서 실행한 프로그램도 127.0.0.1:8765에 붙을 수 있어요. 여러 사람이 쓰는 Mac에서는 쓰지 마세요.

문제 해결

• oxheed serve가 “address already in use”로 멈추면 이미 다른 oxheed가 8765에서 돌고 있어요. 상태 보기:

~/.oxhee/bin/oxheed status

• launchd 등록을 지우려면:

~/.oxhee/bin/oxheed uninstall

• 화면이 옛 버전으로 보이면 한 번 새로고침하세요(화면 캐시가 다음 로드부터 바뀌어요).