kaivo

맥에 깔린 모든 AI 툴(Claude·Codex·Gemini…)의 설정 파일을 한 화면에서 편집·비교하는 로컬 웹앱.

이름은 핀란드어로 '우물'. 흩어져 있던 규칙이 모여드는 원천.

요구사항

• macOS
• Node 24 이상 (타입 스트리핑으로 .ts 직접 실행)

설치·실행

npx @token-keeper/kaivo

서버가 뜨고 브라우저가 자동으로 열린다. 이미 떠 있으면 브라우저만 연다.

전역 설치도 가능:

npm install -g @token-keeper/kaivo
kaivo

상주 등록

전역 설치본은 첫 실행에 상주 등록 여부를 한 번 물어본다. y로 답하면 launchd에 등록되어 터미널을 닫거나 재부팅해도 계속 떠 있고, 이후 kaivo는 브라우저만 연다. 거절하면 그 실행에서만 서버가 뜨고(Ctrl+C로 종료) 다시 묻지 않는다.

npx로 실행하면 묻지 않는다 — 패키지가 npm 캐시에 있어 언제든 사라질 수 있는 경로라 상주 대상이 못 된다. 상주하려면 npm install -g @token-keeper/kaivo.

거절을 되돌리려면 rm ~/.kaivo/daemon-declined 후 다시 kaivo.

소스에서 실행

npm install
npm run build
npm start

launchd 상주 등록:

scripts/install-launchd.sh          # 등록 (RunAtLoad + KeepAlive)
scripts/install-launchd.sh uninstall # 해제

기본 포트: 9011 → http://localhost:9011

launchd 제어

launchctl kickstart -k gui/$(id -u)/com.token-keeper.kaivo   # 재시작
launchctl bootout gui/$(id -u)/com.token-keeper.kaivo        # 중지

로그

~/.kaivo/kaivo.log

MVP 4기능

1. 전 툴 설정 파일 트리 탐색 (파일 축 ⇄ 종류 축)
2. 규칙 상세 편집 (CodeMirror 6)
3. 파일 쌍 비교 (diff, 툴 교차 포함)
4. 글로벌↔프로젝트 위치 이동

스펙 문서

• 기획: docs/2026-07-28_AI문서편집기_기획.md
• Tech Spec: docs/02_active/WIP_2026-08-02_kaivoMVP_TECH_SPEC.md