ego lite 설치하고 에이전트 브라우저 자동화 충돌 막기

개요

AI 에이전트에게 웹 브라우저 작업을 맡길 때 제일 먼저 걸리는 게 로그인 세션이다. 별도 자동화 브라우저를 띄우면 쿠키가 텅 비어 있고, 쓰던 브라우저를 그대로 같이 쓰면 사용자 탭과 에이전트 탭이 뒤엉킨다. ego lite는 이 두 문제를 한 번에 겨냥한 Chromium 기반 브라우저다. 사용자는 평소처럼 브라우저를 쓰고, 에이전트는 격리된 Space에서 같은 로그인 상태를 그대로 가져다 쓴다.

저는 이 구조가 Claude Code나 Codex를 자주 쓰는 개발자에게 꽤 현실적이라고 봅니다. 웹 콘솔 확인, 관리자 페이지 입력, QA 화면 캡처처럼 브라우저가 필요한 작업은 많은데, 매번 쿠키와 인증을 새로 맞추는 게 번거롭기 때문입니다. ego lite는 Chrome 데이터 가져오기를 첫 실행 단계에 넣고, 에이전트 쪽엔 ego-browser skill을 붙이는 방식으로 이 부분을 처리합니다.

1. 맞는 환경

• Claude Code, Codex, Cursor 같은 에이전트 CLI에서 웹 조작을 자주 시키는 경우
• 인증된 관리자 페이지, SaaS 콘솔, 내부 대시보드를 에이전트가 읽어야 하는 경우
• 에이전트 작업 중에도 내 탭과 마우스 포커스를 뺏기고 싶지 않은 경우

Windows나 Linux만 쓰는 분에게는 아직 맞지 않습니다. README 기준 현재 앱 설치 경로는 macOS용입니다. 단순히 공개 페이지 스크래핑만 할 거라면 Playwright나 Browser-Use 같은 라이브러리만으로도 충분합니다.

2. 설치와 skill 연결

공식 README의 빠른 설치 경로는 skills CLI입니다. 앱 설치는 Apple Silicon용과 Intel용 DMG를 따로 제공합니다. 첫 실행 때 Chrome 데이터를 가져올지 묻는데, 기존 로그인 세션을 에이전트가 써야 한다면 여기서 가져오기를 선택하시면 됩니다.

npx skills add citrolabs/ego-lite

에이전트가 직접 설치 흐름을 읽게 할 수도 있습니다. 이 경우 저장소의 skills/ego-browser/references/install.md를 읽고 macOS 설치 스크립트, 앱 실행, 온보딩 순서로 진행합니다.

Set up ego lite for me: https://github.com/citrolabs/ego-lite
Read `skills/ego-browser/references/install.md` and follow the steps to install ego lite.

3. Space 작업 흐름

설치 후에는 에이전트 프롬프트에서 /ego-browser 뒤에 할 일을 적으면 됩니다. 예를 들어 ego-browser follow @ego_agent on x.com for me처럼 자연어로 요청하면, 에이전트가 브라우저를 열고 Snapshot을 읽은 뒤 클릭, 입력, 대기, 캡처를 수행합니다.

내부 skill 문서에는 page.snapshot(), page.locator(...), browser.openOrReuseTab(...), taskSpaces.useOrCreate(...) 같은 Playwright 스타일 API가 정리돼 있습니다. 에이전트는 짧은 명령을 여러 번 던지는 대신 ego-browser nodejs heredoc 안에서 여러 동작을 한 번에 묶어 실행합니다. 이 차이가 토큰 사용량과 대기 시간을 줄이는 핵심입니다.

확인

설치 후 현재 쉘에서 명령이 잡히는지부터 확인하시면 됩니다.

command -v ego-browser

명령을 찾지 못하면 ~/.local/bin이 PATH에 들어 있는지 확인해주시면 됩니다. 정상이라면 간단한 에이전트 브라우저 작업을 하나 맡겨서 Space가 분리되는지, 쓰던 탭이 방해받지 않는지 확인합니다. 최신 GitHub Release는 v1.2.5이며, 릴리스 자산으로 ego-browser-v1.2.5.zip이 올라와 있습니다. 기존 자동화 글인 Tasker, n8n, Firefly III 연동 가계부 자동 기록 시스템 구축처럼 웹 화면 확인이 들어가는 흐름에 붙이면 쓰임새가 더 분명해집니다.