
bmux로 화면을 확인하며 실행하는 브라우저 자동화
분할 패널과 CLI로 결과를 확인하는 브라우저 자동화

bmux 사이트는 무엇을 하는 곳인가요?
bmux.cc는 Chromium/Electron 기반 무료 브라우저의 다운로드, 문서와 소스 코드 입구입니다. 참고 페이지를 외부 에이전트가 조작하는 페이지 옆에 놓고 진행 상황을 확인할 수 있습니다. 웹 에이전트 개발이나 여러 자료를 비교하는 연구 작업에 유용합니다.
tmux 방식은 화면 분할과 키보드 사용을 뜻하며 tmux 설치는 필요 없습니다. 확인된 연동은 CLI 제어이고, 내장 모델 구독이나 자연어 작업 계획 기능은 검증되지 않았습니다.
대상 패널을 정하고 결과를 확인하기
일반 비활성 페이지는 실행이 제한됩니다. 지속 작업은 bot 또는 bmux profile create NAME --background로 만든 프로필을 사용합니다. 공식 브라우저 자동화 안내의 시작 순서는 다음과 같습니다.
bmux new-session -s agents --profile bot
bmux list-windows -t agents
bmux list-panes -t <window-id>
bmux navigate -t <pane-id> https://example.com
bmux wait -t <pane-id> --selector 'main' --timeout 15000
bmux dom -t <pane-id>
bmux screenshot -t <pane-id> --output /tmp/page.png
목록에서 반환된 실제 창·패널 ID로 자리표시자를 바꾸고 URL과 선택자를 조정하세요. JSON의 ok/result, 실제 URL, DOM과 PNG를 확인해야 합니다. 닫힌 ID는 재사용될 수 있습니다. type은 커서에 삽입하며 필드를 비우지 않고, 일반 선택자는 주 문서를 대상으로 합니다.
CLI는 이동, 대기, JavaScript, 클릭, 입력과 캡처를 포커스를 빼앗지 않고 처리합니다. 한 패널의 명령은 순차적이고 다른 패널은 독립 작업에 쓸 수 있습니다. 원시 CDP는 Electron 패널 디버거용이며 공개 Playwright 접속점이 아닙니다. 늦게 로드되는 내용은 스크롤하고 기다린 뒤 캡처합니다.
기본 로컬 보호는 10분 작업 후 20분 휴식, 소셜 사이트 동작 사이 최소 2초입니다. 경고·인증·제한을 만나면 멈추며 수동 해결이 필요합니다. 플랫폼 승인이나 계정 제한 방지를 보장하지 않습니다.
작업 배치와 계정 프로필 구분하기
가로·세로 분할, 떠 있는 패널, 고정과 배치 저장을 지원합니다. Ctrl+B 뒤 %, 큰따옴표, s, ?로 분할·세션 선택·도움말을 사용합니다. 세션 안에 내부 창과 패널이 있고 데스크톱 클라이언트가 세션에 연결됩니다.
프로필은 쿠키, 사이트 저장소, 기록, 권한과 연결을 보관합니다. 같은 프로필은 로그인을 공유하므로 별도 세션만으로 계정이 분리되지는 않습니다. 패널 프로필은 고정되어 다른 계정은 새 패널이 필요합니다.
클라이언트를 분리해도 페이지는 실행되지만 Quit은 브라우저를 종료합니다. 재시작은 URL·배치를 다시 열 뿐 모든 JavaScript 상태나 미저장 폼을 복구하지 않습니다. 배치 복원은 현재 페이지를 대체합니다.
광고·추적 차단, Dark Reader, 북마크, 기록과 암호화한 일반 폼 저장이 있습니다. 채우기는 제출하지 않고 민감 필드는 제외합니다. Bitwarden 등 확장은 실험 단계이며 클라우드 동기화와 기존 Chrome/Brave 창 삽입은 지원하지 않습니다.
모바일 설정과 프록시로 확인할 수 있는 범위
Pixel 8, Galaxy S24, iPhone 15 Pro/Pro Max는 뷰포트, 밀도, 터치와 식별 정보를 바꿉니다. 방향, 언어, 시간대와 선택적 위치를 설정할 수 있습니다. iPhone도 Chromium이므로 Safari나 실제 기기 시험을 대신하지 못합니다.
프로필의 HTTP/HTTPS/SOCKS5를 시험하고 출구 IP를 확인해 새 패널에 저장합니다. 기존 패널은 이전 연결을 유지합니다. safeStorage가 인증 정보를 암호화하며 연결을 바꿀 때 쿠키를 복사할 수 있으므로 다른 계정에는 새 프로필을 쓰세요.
수집은 한 백그라운드 작업자로 작은 스크롤·대기·DOM 읽기를 검증하고 추가 작업자를 늘리는 흐름입니다. 호스팅 API나 완성된 크롤러·내보내기 서비스는 확인되지 않았습니다. 자세한 설정은 프로필·프록시·기기 설정입니다.
로컬 권한과 원격 접근 이해하기
데이터는 앱 디렉터리, 북마크는 로컬 YAML에 있고 BMUX_DATA_DIR로 인스턴스를 나눕니다. 소켓은 현재 OS 사용자만 쓰고 기본 네트워크 디버깅 포트는 없지만 CLI가 모든 프로필을 조작합니다. 로컬 스크립트 플러그인도 사용자 권한으로 실행됩니다.
원격 호스팅과 접근 권한는 Linux Electron/Xvfb 호스트와 웹·데스크톱 보기를 설명합니다. 소유자가 Watch/Control을 부여하고 WebRTC가 영상·입력·페이지 상태를, 서비스가 접근·메타데이터를 처리합니다. 활동·횟수 이력은 30일이며 보고는 최선 노력 방식입니다. 일정·재시도·영구 결과는 별도 큐가 맡아야 합니다. 전체 데이터의 무보관·학습 제외 약속은 확인하지 못했습니다.
최신 다운로드, 무료 범위와 라이선스
2026년 10월 4일 기준 최신 다운로드와 릴리스 안내는 v0.1.5이며 macOS Apple Silicon/Intel, Windows x64, Linux x64/arm64 호스트 파일을 제공합니다. Linux는 별도 배포입니다. Mac은 brew install --cask tonisives/tap/bmux를 쓸 수 있습니다. CLI에는 Node 22.12+, 개발에는 pnpm 11이 필요합니다.
배포자는 Mac 서명·공증과 손상된 v0.1.3 수정 사실을 안내합니다. Mac 배포판은 시작·매일 확인하고 종료 때 업데이트를 적용합니다. Windows/Linux는 수동 다운로드이며 v0.1.3은 먼저 수동 업그레이드합니다.
브라우저는 무료이나 외부 모델·프록시·서버는 비용이 들 수 있습니다. 현재 GPL 라이선스는 GPL v3이고 메타데이터는 GPL-3.0-only, 이전 MIT 고지는 보존됩니다. 오래된 사이트 표시로 현재 라이선스를 판단하지 마세요. 초기 프리뷰이므로 실제 로그인·DRM·확장을 시험해야 합니다.
bmux 자주 묻는 질문
AI 에이전트는 bmux를 어떻게 제어하나요?
명시적 패널 ID와 CLI로 동작, DOM 읽기, 캡처를 합니다. JSON과 보이는 결과를 확인하고 지속 작업에는 백그라운드 프로필을 사용하세요.
bmux는 무료인가요?
현재 브라우저는 무료이며 GPL입니다. 외부 모델·프록시·인프라 비용은 별도이고 포함 모델 크레딧은 확인되지 않았습니다.
프로필이 완전한 보안 격리를 제공하나요?
아닙니다. 웹 데이터는 나누지만 현재 사용자 CLI가 전체 프로필에 접근합니다. 원격 권한도 따로 설정해야 합니다.
공식 자료와 개발자 지원
- 공식 소스 저장소: 현재 README와 소스.
- 공개 문제 신고: 알려진 문제와 재현 가능한 오류.
- 브라우저 도구 안내: 읽기·북마크·폼 설정.
별도 공식 소셜 커뮤니티, 상태 페이지나 보장된 응답 시간은 검증되지 않았습니다.





