GitHub가 Hover Trans Port(로컬 AI CLI 기반 크롬 확장 프로그램)의 소스 코드를 공개했다. 이 도구는 웹페이지에서 텍스트를 선택하거나 문단 위에 마우스를 올린 뒤 단축키를 누르면, 원문 근처에 번역 결과를 즉시 표시하는 인라인 번역 기능을 제공한다. 기존의 브라우저 기본 번역이 가진 문맥 왜곡 문제와 AI 번역기를 사용할 때마다 API 키를 발급받거나 추가 구독을 관리해야 하는 번거로움을 해결하기 위해 설계되었다.

특히 사용자가 이미 로컬 환경에서 사용 중인 Codex CLI(코드 생성 및 텍스트 처리 도구)나 Claude CLI(Anthropic의 AI 인터페이스)의 인증 상태를 그대로 브라우저로 끌어오는 구조를 취한다. 확장이 직접 API 키를 저장하지 않고 Native Messaging(브라우저와 로컬 애플리케이션 간 통신 규격)을 통해 로컬 헬퍼를 거쳐 CLI를 호출하는 방식이다. 현재 macOS 환경의 크롬 브라우저에서 언팩드 확장(unpacked extension) 형태로 설치해 사용할 수 있으며, 로컬 SQLite를 통한 번역 캐싱을 지원해 반복 요청의 효율을 높였다.

Hover Trans Port의 주요 기능과 macOS 설치 사양

웹페이지에서 모르는 문장을 만났을 때 텍스트를 긁어 번역기에 붙여넣거나 브라우저 전체 번역을 돌리는 과정은 개발자에게 꽤나 소모적인 작업이다. 전체 번역은 문맥을 놓치기 쉽고 AI 번역기를 개별적으로 쓰려면 API 키 발급부터 구독 관리까지 신경 쓸 일이 늘어나기 때문이다. Hover Trans Port(호버 트랜스 포트, 마우스 호버 기반 번역 도구)는 이 지점에서 로컬 AI CLI(명령줄 인터페이스)를 브라우저와 직접 연결하는 방식을 제안한다. 이미 터미널에서 Codex CLI(코덱스 CLI, OpenAI 기반 코드 및 텍스트 처리 도구)나 Claude CLI(클로드 CLI, Anthropic 기반 AI 도구)를 로그인해 사용 중인 개발자라면 추가적인 설정 없이 기존 인증 상태를 그대로 활용해 브라우저 내에서 번역 기능을 즉시 호출할 수 있다. 이는 도구의 파편화를 싫어하고 이미 구축된 로컬 환경을 선호하는 개발자들의 성향을 정확히 파고든 지점이다.

기술적인 핵심은 Chrome 확장 프로그램이 Native Messaging(네이티브 메시징, 브라우저와 로컬 애플리케이션 간 통신 규격)을 통해 로컬 헬퍼를 호출하고, 이 헬퍼가 다시 시스템에 설치된 CLI를 실행하는 구조에 있다. 사용자가 특정 텍스트를 선택하거나 문단 위에 마우스를 올린 뒤 단축키를 누르면 번역 결과가 원문 근처에 인라인 형태로 표시되어 읽기 흐름을 깨지 않는다. 팝업창을 띄우거나 탭을 전환하는 번거로움 없이 원문 바로 옆에서 의미를 확인하는 직관성을 강조했다. 효율적인 리소스 관리를 위해 로컬 SQLite(에스큐엘라이트, 파일 기반 경량 관계형 데이터베이스) 번역 캐시를 도입해 한 번 번역한 내용은 빠르게 다시 불러온다. 특히 확장 프로그램이 API 키나 OAuth 토큰, 브라우저 쿠키 같은 민감한 세션 정보를 직접 저장하지 않고 사용자가 이미 인증해둔 로컬 CLI의 권한을 빌려 쓰는 설계로 보안성을 높였다.

현재 설치 및 사용 환경은 macOS와 Chrome 브라우저 조합으로 제한되며, Chrome 웹 스토어에 등록되지 않은 unpacked extension(언팩드 익스텐션, 압축을 푼 상태의 확장 프로그램) 형태로 배포된다. 일반 사용자에게는 진입장벽이 높을 수 있는 방식이지만, 개발자 커뮤니티에서는 소스코드를 직접 확인하고 설치하는 언팩드 방식이 오히려 신뢰도를 높이는 요소로 작용한다. 사용자는 제공되는 macOS native host installer(맥OS 네이티브 호스트 인스톨러)를 통해 로컬 헬퍼를 설치해야 정상적인 작동이 가능하다. 윈도우나 리눅스 운영체제 지원은 아직 이루어지지 않았으며 전체 페이지를 자동으로 번역하는 기능 역시 구현 범위에서 제외되었다. 로컬 중심의 아키텍처를 가졌지만 완전한 오프라인 번역기는 아니며, 요청 텍스트는 선택한 CLI의 정책에 따라 외부 AI 서비스로 전송된다. 관련 소스코드와 상세 가이드는 GitHub에서 공개되어 있다.

API 키 관리 없는 Native Messaging 기반의 동작 구조

기존 AI 번역 확장 프로그램들의 진입 장벽은 항상 설정 창의 API 키 입력란에서 시작된다. 사용자가 직접 OpenAI나 Anthropic 같은 서비스 제공자 페이지에 접속해 키를 발급받고, 이를 복사해 확장 프로그램 설정에 붙여넣는 과정이 필수적이었다. 개발자 커뮤니티에서는 이런 반복적인 작업이 번거로울 뿐 아니라, 브라우저 확장 프로그램이라는 제3의 소프트웨어에 민감한 인증 정보를 저장하는 것에 대해 보안상 찝찝함을 느끼는 반응이 많았다. 특히 API 키 유출 사고가 빈번한 상황에서 로컬 저장소에 평문이나 간단한 암호화로 키를 보관하는 방식은 늘 논쟁의 대상이었다.

Hover Trans Port(로컬 AI CLI 연동 브라우저 번역기)는 이 연결 고리를 완전히 끊어내며 접근 방식을 바꿨다. 동작 흐름을 보면 Chrome Extension에서 시작해 Native Messaging(브라우저와 로컬 애플리케이션 간 통신을 가능하게 하는 Chrome API)을 거쳐 로컬 helper를 호출하고, 최종적으로 Codex CLI(OpenAI 기반 명령줄 인터페이스 도구)나 Claude CLI(Anthropic 기반 명령줄 인터페이스 도구)를 실행하는 구조다. 브라우저가 직접 AI 서버에 API 요청을 보내는 것이 아니라, 이미 사용자의 PC에 설치되어 인증이 완료된 CLI 도구를 대리인으로 활용해 결과값만 수신하는 방식이다.

여기서 개발자들이 주목하는 지점은 확장 프로그램이 그 어떤 인증 정보도 직접 다루지 않는다는 사실이다. API 키는 물론이고 OAuth 토큰, 브라우저 쿠키, 서비스 세션 토큰을 저장하는 로직 자체가 없다. 이미 터미널 환경에서 AI 도구를 세팅해둔 파워 유저들에게 다시 API 키를 입력하게 만드는 것은 비효율의 극치라는 맥락이 작용했다. 로컬에 존재하는 인증 세션을 그대로 활용함으로써 보안 리스크를 원천적으로 차단하고 설정 단계를 획기적으로 줄인 셈이다. 이는 인증의 주체를 브라우저에서 로컬 OS 환경으로 완전히 이관시킨 설계다.

결과적으로 기존 방식이 클라우드 기반의 중앙 집중식 인증이었다면, 이번 구조는 철저히 로컬 중심의 분산 호출 방식에 가깝다. 사용자가 이미 설치해둔 CLI의 권한을 그대로 이용하기 때문에 별도의 구독 관리 페이지를 오갈 필요가 없다. 단순한 번역 도구를 넘어 브라우저 확장 프로그램이 로컬 시스템의 자원을 어떻게 안전하게 호출할 수 있는지에 대한 실전 사례를 보여준다. 관련 상세 구현 내용은 GitHub 저장소 https://github.com/monk-lee/hover-trans-port 에서 확인할 수 있으며, 특히 macOS 환경에서 native host installer를 통해 로컬 헬퍼를 설치하는 과정은 개발자 친화적인 제어권을 제공한다는 평이다.

로컬 CLI 생태계의 브라우저 확장과 실무자 체감 변화

개발자가 웹 서핑 중 모르는 문장을 만났을 때 가장 먼저 하는 행동은 텍스트를 긁어 새 탭을 열고 AI 번역기에 붙여넣는 일이다. 이 단순한 과정에서 발생하는 컨텍스트 스위칭(작업 맥락 전환)은 생각보다 치명적이다. 집중력이 흩어지고 작업 흐름이 끊기기 때문이다. Hover Trans Port(로컬 AI CLI 연동 브라우저 확장 도구)는 이 지점을 정확히 파고든다. 텍스트를 선택하거나 마우스를 올린 뒤 단축키만 누르면 원문 근처에 바로 번역 결과가 뜬다. 탭을 오가는 물리적 이동과 시간 낭비가 사라지면서 브라우징과 정보 습득의 리듬이 완전히 바뀐다.

보안에 민감한 개발자들 사이에서 브라우저 확장 프로그램에 API 키를 직접 입력하는 행위는 기본적으로 기피 대상이다. 내 소중한 토큰이 어디로 흘러갈지 모른다는 불안감이 크고 권한 설정에 대한 불신이 있기 때문이다. 이번 시도가 뜨거운 이유는 인증 정보를 브라우저에 맡기지 않는 로컬 중심 제어 방식을 택했기 때문이다. 구조를 보면 Chrome Extension(크롬 확장 프로그램)이 Native Messaging(브라우저와 로컬 앱 간 통신 규격)을 통해 로컬 헬퍼를 거쳐 이미 인증된 Codex CLI(코드 생성 및 처리 명령줄 도구)나 Claude CLI(클로드 기반 명령줄 도구)를 호출한다. API 키, OAuth 토큰, 브라우저 쿠키, 서비스 세션 토큰을 확장 프로그램이 직접 저장하지 않도록 범위를 좁혔기에 보안적 심리 장벽을 획기적으로 낮췄다.

현재는 macOS와 크롬 환경의 언팩드 확장(개발자 모드로 설치한 확장) 상태로 제한적이지만 커뮤니티의 기대는 더 넓은 확장성에 쏠려 있다. 윈도우와 리눅스 지원이 추가되고 전체 페이지 자동 번역 기능까지 구현된다면 단순한 편의 도구를 넘어선다. 이는 CLI 기반의 AI 워크플로우를 웹 브라우징 영역까지 완전히 통합하려는 시도로 읽힌다. 터미널에서만 누리던 AI의 효율성을 웹 서핑이라는 일상적 행위 속으로 끌어들인 셈이다. 개발자들은 이제 브라우저라는 샌드박스를 넘어 로컬의 강력한 도구들을 직접 호출하는 방식에 주목하고 있다.

실무자들은 이를 단순한 번역기 추가가 아니라 제어권의 확장으로 받아들인다. 로컬 SQLite(경량 관계형 데이터베이스)를 활용한 번역 캐시 기능은 반복되는 요청을 줄여 응답 속도를 높이고 API 비용을 아끼는 실질적 이득을 준다. 결국 개발자가 이미 구축해 놓은 로컬 AI 생태계를 브라우저라는 창구와 연결함으로써 도구 간의 파편화를 해결하는 방향으로 진화하고 있다. https://github.com/monk-lee/hover-trans-port 저장소에서 보여주는 이러한 접근법은 로컬 우선주의를 지향하는 개발자들에게 단순한 기능 추가 이상의 워크플로우 개선 경험을 제공한다.