ONEDEV

agent-workspace-linux

AI Agent SandboxesskillRust

★ 98주당 +28조회 5

무엇인가

이 스킬은 AI 에이전트가 사용자의 실제 화면·입력 장치·브라우저 세션을 점유하지 않고, 에이전트 전용의 숨겨진 Linux 데스크톱에서 GUI와 웹 작업을 수행하도록 작업 절차와 도구 사용 규칙을 주입한다. 규율하는 문제 영역은 화면·포커스·클립보드·로그인 세션의 소유권이며, 에이전트가 조작하는 대상은 항상 별도 디스플레이 안의 프로세스로 한정된다.

어떻게 동작하나

동작은 규칙 파일과 실행 바이너리의 결합으로 이뤄진다. 저장소는 Rust로 빌드되는 MCP 서버와 skills/agent-workspace-linux/ 아래의 스킬 파일을 함께 배포하고, install.sh가 바이너리를 ~/.local/bin/에, 스킬을 ~/.codex/skills/에 복사한 뒤 MCP 호스트에 stdio 서버로 등록한다. 에이전트는 workspace start, workspace launch, workspace observe, browser-navigate, browser-snapshot 같은 MCP 도구를 호출해 headless X11 디스플레이에 창 관리자·앱·클립보드·Chrome을 띄우고 타이핑·클릭·스크린샷·탐색을 수행한다. 워크스페이스 생성은 --ack-hidden-workspace 명시를 요구하고, --dry-run으로 생성 전에 계획을 확인할 수 있다.

무엇과 다른가

프롬프트에 브라우저를 조작하라고 서술하는 방식과 달리, 실제로 분리된 디스플레이와 프로세스 경계를 제공한다. 자매 프로젝트 computer-use-linux가 사용자의 실제 데스크톱을 구동하는 데 반해 이 스킬은 에이전트 소유 환경만 다루며, 두 도구는 상호 보완 관계로 설계되어 있다. 규칙 텍스트만 배포하는 일반 스킬과도 달리 시스템 패키지 의존성과 실행 바이너리, MCP 등록을 함께 요구한다.

어떻게 쓰나

설치는 Linux에서 sudo apt install xvfb openbox xdotool xauth x11-utils imagemagick xclip bubblewrap pkg-config libxkbcommon-x11-dev 후 ./install.sh를 실행한다. install.sh는 재실행이 안전하고 --permissions, --skills-dir, --no-skill, --dry-run, --clean-codex-config 플래그를 받는다. cargo install --git https://github.com/agent-sh/agent-workspace-linux 또는 npm 래퍼 @agent-sh/agent-workspace-linux로도 설치할 수 있으며, 후자는 바이너리만 설치하므로 .mcp.json에 command와 args ["mcp"]를 직접 등록해야 한다. 첫 사용은 doctor로 환경을 점검하고, workspace start --dry-run으로 미리보기한 뒤 --ack-hidden-workspace --purpose로 생성을 확정하고, viewer로 부동 뷰어를 띄우는 순서다.

전제와 한계

전제는 Linux이며 xvfb·openbox·xdotool·bubblewrap 등 선행 패키지가 필요하다. MCP를 지원하는 호스트(Claude Code, Codex 등)에서 동작하고, Codex에서는 전용 Agent Workspaces 페이지로 백엔드와 권한 상한을 설정하는 경로가 안내된다. 실제 데스크톱 구동은 이 스킬의 대상이 아니며, 브라우저 명령은 워크스페이스 소유 Chrome과 loopback DevTools가 있어야 동작한다. DevTools 포트는 임시 포트로 바인딩되고 Origin 허용 목록이 포트까지 일치해야 하므로, 외부 CDP 클라이언트는 Origin 헤더를 생략해야 접속된다.

관련 논문 1

유사 도구