terminal-browser
terminal-browser · by zenbu-labs
Claude Code 화면에서 브라우저를 열어 웹사이트를 미리 볼 수 있어요. 에이전트가 직접 열고 닫으며, 별도로 설치한 terminal-browser 앱이 브라우저 엔진을 실행해요.
❯ /plugin marketplace add SeongGwangJu/k-mods ❯ /plugin install terminal-browser@k-mods
$ claude plugin marketplace add SeongGwangJu/k-mods $ claude plugin install terminal-browser@k-mods
이미 열려 있는 세션에는 /reload-plugins로 바로 적용돼요. Claude Code 2.1.287 이상이 필요해요.
알아 둘 점
- 실제 브라우저 엔진(Electron+크로미움, 네이티브 입력 리스너)은 별도 설치되는 terminal-browser 앱에 있고, 이 mod는 그 앱을 띄워 로컬 HTTP로 통신하는 얇은 다리 역할만 해요. 그 앱은
terminal-browser upgrade로 독립적으로 업데이트되므로 여기 고정한 커밋과 무관하게 바뀔 수 있어요. - terminal-browser 앱은 기본적으로 의사 익명 사용량·크래시 텔레메트리를 수집해요(
~/.local/state/terminal-browser-*/logs/telemetry.jsonl에 평문 기록,DO_NOT_TRACK=1등으로 끌 수 있음). 이 mod의 훅 코드 자체는 텔레메트리를 보내지 않아요. - 에이전트가 브라우저를 직접 열고 닫는 도구(
open/close)는agentTool설정이 기본 꺼짐이라 기본값에서는 등록되지 않아요. 켜면 에이전트가 임의 URL을 열 수 있어요. - 명시된 최소 Claude Code 버전은 없어요. README는
CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1설정을 안내하는데, k-mods의 다른 리뷰(ko-ui)에서는 이 플래그가 2.1.285 이하에서만 필요하고 2.1.287부터 함수 훅이 기본 활성화라고 확인했어요. terminal-browser 쪽 안내가 구버전 기준일 가능성이 있고, 직접 실행 검증은 하지 않았어요.
준비물
- terminal-browser CLI/앱 설치 (curl -fsSL https://terminal-browser.sh/install | bash 또는 brew install terminal-browser). Electron 기반 별도 프로그램, 이 플러그인 코드에는 포함되지 않음
- Kitty 그래픽 프로토콜을 지원하는 터미널(ghostty, kitty, 또는 libghostty 기반). 미지원 터미널·멀티플렉서(tmux 등)에서는 TUI가 깨질 수 있음
이 mod가 내 컴퓨터에서 하는 일
mod는 샌드박스 없이 내 권한으로 실행돼요. 정적 분석으로 확인한 범위예요.
네트워크프로그램 실행도구 호출 제어프롬프트 입력파일 읽기
정적 분석 결과
다루는 이벤트
