# 인앱 브라우저 — Liu Terminal

> Liu Terminal 인앱 웹 브라우저. 로컬 서버 미리보기, 요소 선택기, 연결 오류 Ask Agent 통합 기능이 탑재된 내장 macOS 네이티브 WebView.

URL: https://liu.software/ko/docs/browser/  
Language: ko  
Updated: 2026-10-17

## 앱 내 브라우저

macOS의 임베디드 WKWebView를 통해 터미널 바로 옆에서 로컬 호스트 및 일반 웹 미리보기를 지원하며, 엘리먼트 선택과 연결 오류 시 Ask Agent 기능을 제공합니다.

## 브라우저 열기

- 명령 팔레트 → Browser (새 브라우저 탭; 최대 BROWSER\_MAX\_TABS = 4개 지원).
- Browser Split Right / Left / Below / Above — 터미널 창 옆이나 아래에 WebView를 배치합니다.
- 개발 서버가 가동 중일 때 Site Manager에서 직접 실행.

마스터 스위치: config.json 파일의 browser\_enabled (기본값 true). 빠른 재오픈을 위해 마지막 URL과 최대 8개의 최근 기록이 저장됩니다.

플랫폼 참고: 임베디드 WebKit 뷰는 macOS 기능입니다. Linux 빌드에서는 브라우저 API가 스텁으로 유지되므로 브라우저 탭과 WebView 분할을 사용할 수 없습니다.

## 탐색

주소 표시줄, 뒤로/앞으로 이동, 새로고침 — 앱 내에서 안전하게 실행되는 표준 WebKit 동작입니다. 에이전트가 옆 터미널 분할창에서 코드를 수정하는 동안 UI를 확인하기에 매우 적합합니다.

## 요소 선택 (Select Element)

명령 팔레트 → Select Element를 사용하여 선택 모드를 활성화합니다. 실제 웹 페이지에서 요소를 클릭하면 Liu가 선택자, 태그, 텍스트, 크기, HTML을 캡처하여 에이전트 프롬프트에 컨텍스트로 추가합니다. Attach Element는 마지막 선택 요소를 재전송합니다. 스크린샷이 필요 없습니다.

## 오류 발생 시 에이전트에게 묻기 (Ask Agent)

페이지 로드에 실패할 경우(개발 서버 중지, 연결 거부 등), 오류 UI창을 통해 로그 및 환경 컨텍스트를 코딩 에이전트에 전달하여 서버를 복구하고 재실행할 수 있도록 유도할 수 있습니다.

[다음 Markdown 뷰어 →](https://liu.software/ko/docs/markdown.md)