프로젝트 소개

agent-workspace-linux는 Linux 전용 도구로, AI 에이전트에게 사용자의 실제 데스크톱과 분리된 자체 헤드리스 X11 데스크톱 환경을 제공합니다. 이 도구는 숨겨진 Xvfb 디스플레이와 창 관리자, 클립보드, 작업공간 전용 Chrome/Chromium 브라우저를 실행하며, 모두 stdio를 통한 Model Context Protocol(MCP)로 제어됩니다. 이를 통해 에이전트는 사용자의 마우스를 움직이거나 포커스를 빼앗거나 로그인된 브라우저 세션에 간섭하지 않고 GUI 테스트, 웹사이트 QA, 브라우저 자동화를 수행할 수 있습니다. 이 프로젝트는 명확한 권한 경계를 강조합니다. 기본적으로 MCP 호스트(예: Claude Code 또는 Codex)가 승인 흐름을 소유합니다. 개발자는 선택적으로 JSON 파일이나 환경 변수를 통해 하드 권한 상한을 강제할 수 있으며, MCP 프론트엔드와 작업공간 데몬의 IPC 소켓 모두에서 네트워크 모드, 마운트 경로, 앱 허용 목록을 제한합니다. 부동 GPUI 뷰어는 일시 중지, 읽기 전용, 중지 컨트롤과 함께 실시간 관찰을 제공합니다. 주요 기능으로는 창 목록, 스크린샷, 키보드/마우스 입력, 클립보드 접근, 앱별 로그, 저장 가능한 작업공간 프로필, 루프백 Chrome DevTools Protocol 엔드포인트를 통한 브라우저 자동화가 있습니다. 번들된 스킬은 점진적 도구 로딩을 가능하게 하여 에이전트가 필요할 때만 약 86개의 사용 가능한 도구를 로드합니다. 설치 방법으로는 셸 스크립트, 소스에서 cargo, npm 래퍼, 또는 x86_64 및 aarch64용 사전 빌드 바이너리를 지원합니다. 제한 사항으로는 Linux 전용 지원, 1.0 미만 인터페이스 안정성, 단일 사용자 신뢰 모델, 강제 마운트 및 네트워크 격리를 위한 bubblewrap 요구 사항이 있습니다. 이 프로젝트는 MIT 라이선스이며, 사용자의 실제 데스크톱을 구동하는 자매 도구인 computer-use-linux를 보완합니다.