MCP 또는 HTTP API로 AI 에이전트가 실제 로그인 세션에서 작동하는 Electron 기반 로컬 우선 브라우저입니다.
zenbu-labs/terminal-browser
kitty graphics protocol을 사용해 터미널 안에 웹 페이지를 직접 렌더링하는 Chromium 기반 브라우저입니다.
- 스타
- 4,482
- 포크
- 221
- 열린 이슈
- 110
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
terminal-browser는 터미널 창에서 실행되는 그래픽 웹 브라우저입니다. Electron의 오프스크린 렌더링으로 Chromium을 구동해 페이지를 그린 다음, Ghostty, kitty, VS Code 터미널처럼 kitty graphics protocol을 지원하는 터미널에 픽셀을 전송합니다. 터미널에서 입력한 키보드와 마우스 이벤트는 페이지로 전달되므로, 셸을 벗어나지 않고 일반 웹사이트를 탐색할 수 있습니다.
이 브라우저는 터미널 중심의 작업 흐름에 잘 맞습니다. 코딩 에이전트 옆의 분할 창에서 열 수 있으며, 에이전트는 agent-browser 호환 CLI를 통해 열린 브라우저 탭을 제어할 수 있습니다. `--ssh` 옵션을 사용하면 네트워크 요청을 원격 머신으로 프록시해, 해당 머신의 localhost에서 제공되는 페이지를 로컬에서 미리 볼 수 있습니다. 터미널이 간단한 소켓 API를 제공하면 브라우저가 창을 열거나 포커스를 옮기고, 에이전트에 텍스트를 보낼 수도 있습니다.
macOS와 Linux에서는 curl 스크립트나 Homebrew로, Windows에서는 WSL을 통해 설치할 수 있습니다. 프로젝트에는 그래픽 터미널 애플리케이션을 만들기 위한 JavaScript 라이브러리 `pixel`과 Claude Code 플러그인도 포함되어 있습니다.
핵심 기능
- 01kitty graphics protocol을 지원하는 터미널에서 Chromium 웹 페이지 전체를 렌더링합니다.
- 02터미널의 마우스, 트랙패드, 키보드 입력을 페이지로 전달합니다.
- 03분할 창에서 실행할 수 있으며 탭, 명령 팔레트, 페이지 내 검색, devtools를 지원합니다.
- 04SSH를 통해 네트워크 요청을 프록시해 원격 localhost 페이지를 로컬에서 볼 수 있습니다.
- 05열린 브라우저를 스크립트로 제어할 수 있는 agent-browser 호환 CLI를 제공합니다.
- 06tmux와 WezTerm을 비롯해 여러 터미널 및 멀티플렉서와 연동하는 기능이 내장되어 있습니다.
활용 사례
- 코딩 에이전트와 에이전트가 작업하는 웹 페이지를 같은 터미널 탭에 두기.
- 데스크톱 브라우저 없이 SSH를 통해 원격 서버에서 실행 중인 웹사이트 미리 보기.
- CLI를 통해 AI 에이전트가 웹 페이지를 읽거나 조작하도록 하기.
- 에이전트가 생성한 HTML 계획을 에이전트 옆의 분할 창에서 확인하기.
빠른 시작
- 1
Homebrew로 설치(macOS 및 Linux)
brew install terminal-browser - 2
브라우저 실행
terminal-browser - 3
특정 URL 열기
terminal-browser open <url>
사용 전 알아둘 점
- Windows는 WSL을 통해서만 지원되며, WSL에서 필요한 그래픽 프로토콜을 지원하는 터미널은 많지 않습니다.
- kitty graphics protocol을 지원하는 터미널이 필요합니다.
- 텔레메트리와 충돌 보고서는 기본적으로 수집되며, 원하지 않는 경우 직접 비활성화해야 합니다.
- Chrome 확장 프로그램은 아직 지원되지 않으며 디자인 모드는 개발 중입니다.
포함된 컬렉션
토픽
자주 묻는 질문
- terminal-browser은(는) 무엇인가요?
- kitty graphics protocol을 사용해 터미널 안에 웹 페이지를 직접 렌더링하는 Chromium 기반 브라우저입니다. terminal-browser는 터미널 창에서 실행되는 그래픽 웹 브라우저입니다. Electron의 오프스크린 렌더링으로 Chromium을 구동해 페이지를 그린 다음, Ghostty, kitty, VS Code 터미널처럼 kitty graphics protocol을 지원하는 터미널에 픽셀을 전송합니다. 터미널에서 입력한 키보드와 마우스 이벤트는 페이지로 전달되므로, 셸을 벗어나지 않고 일반 웹사이트를 탐색할 수 있습니다.
- terminal-browser은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- terminal-browser은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- terminal-browser은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. terminal-browser의 마지막 커밋은 2026년 11월 5일입니다.
- terminal-browser은(는) 어디에 사용할 수 있나요?
- 코딩 에이전트와 에이전트가 작업하는 웹 페이지를 같은 터미널 탭에 두기. 데스크톱 브라우저 없이 SSH를 통해 원격 서버에서 실행 중인 웹사이트 미리 보기. CLI를 통해 AI 에이전트가 웹 페이지를 읽거나 조작하도록 하기. 에이전트가 생성한 HTML 계획을 에이전트 옆의 분할 창에서 확인하기.
- terminal-browser는 어떻게 설치하나요?
- Homebrew로 설치(macOS 및 Linux): brew install terminal-browser 브라우저 실행: terminal-browser 특정 URL 열기: terminal-browser open <url>
- terminal-browser은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zenbu-labs/terminal-browser
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
여러 AI 채팅 서비스(ChatGPT, Claude, Gemini 등)를 격리된 별도 창에서 사용하고, 프롬프트를 공유하며 내장 터미널도 제공하는 데스크톱 앱입니다.
출시용 앱 빌드 결과물이 rea 같은 AI 역공학 에이전트에 얼마나 노출되는지 평가하고, 안전하게 수정할 수 있는 항목은 해결하는 원커맨드 CLI입니다.
ungoogled-chromium 기반의 macOS, Linux, Windows용 개인정보 보호 중심 Chromium 브라우저입니다.