|

ego lite: 사람과 AI 에이전트가 함께 쓰는 데스크톱 브라우저

Byjw-codex

사람과 AI 에이전트가 같은 브라우저에서 각자의 작업공간을 쓰고, 로그인된 웹사이트의 작업을 에이전트에게 맡길 수 있는 데스크톱 브라우저예요.

주요 기능

  • 에이전트는 별도 Space 안에서 페이지를 열고 구조화된 Snapshot을 읽어 탐색·입력·클릭·파일 작업을 수행해요. 사용자는 원래 작업을 계속하면서 해당 Space의 제어를 넘겨받을 수 있어요.
  • Codex·Claude Code·Cursor 등 기존 에이전트가 ego-browser 스킬을 읽고 JavaScript API를 사용해요. 브라우저 자체가 모든 작업을 이해하는 독립 AI 모델을 기본 제공한다는 뜻은 아니에요.
  • TaskSpace·Page API는 작업공간·탭·페이지 라벨·사용자 제어권과 작업 종료를 구분해요. Snapshot은 텍스트 기반 관찰이며 화면 캡처와 같지 않습니다.
  • 사용자 로그인 환경을 활용할 수 있도록 설계되었지만 모든 사이트의 로그인·자동완성·CAPTCHA·보안 확인이 자동으로 통과된다는 보장은 없어요. 기존 일반 탭이 에이전트에게 무조건 전부 노출되는 구조로 이해하면 안 돼요.
  • 페이지의 선택자·입력·대기·팝업·파일 업로드와 다운로드 API를 제공해요. Playwright와 비슷한 이름이 있어도 지원하는 별도 API 집합이며, 임의의 Playwright 메서드를 사용할 수 있는 것은 아니에요.

구조

  • 구성은 ① 별도로 설치하는 ego lite 브라우저와 네이티브 실행기 ② ego-browser 진입 스킬 ③ 설치된 브라우저가 출력하는 버전별 사용 가이드 ④ TypeScript/JavaScript SDK예요. 공개 저장소는 스킬·SDK·문서·플러그인 묶음을 제공하며, 네이티브 Chromium 앱 전체 구현을 이 저장소만으로 검토한 것은 아니에요.
  • 브라우저의 실행기가 ego-browser nodejs에 전달한 스크립트를 Node 환경에서 실행하고, 브라우저가 제공하는 globalThis.ego 네이티브 브리지 위에 taskSpace·Page 등의 도우미를 올립니다. 페이지 DOM을 읽는 코드는 page.evaluate 안에서 실행하며 Node 스크립트의 변수·모듈과 구분해요.
  • 진입 스킬은 실제 API 전체를 담지 않고 ego-browser skill 출력을 읽도록 연결해요. 해당 명령은 실행 SDK와 같은 위치의 사용 가이드를 반환해야 해요. 따라서 SKILL.md 파일 존재만으로 설치된 브라우저와 호환되는 연결이 완성되었다고 판단할 수 없어요.
  • 확인 커밋에서 스킬·Codex 플러그인 버전은 2.1.0, 개발용 package.json 버전은 0.1.0예요. 노트북에서 전달받은 브라우저 버전 0.6.1.13과 서로 다른 구성요소의 버전이므로 숫자를 맞추려 하면 안 돼요. GitHub v2.1.0 릴리스의 ZIP도 브라우저 EXE가 아니라 ego-browser 통합 스킬 묶음이에요.

누구에게 쓸모 있나요

기존 Codex·Claude Code 등으로 로그인된 업무 사이트를 읽거나 반복 웹 작업을 맡기고, 사람의 작업 탭과 에이전트 작업을 분리해 보고 싶은 사용자에게 적합해요. 웹 UI 품질 점검과 공개 정보 수집에도 쓸 수 있지만 서버용 Linux 무화면 자동화를 바로 대체하는 제품으로 소개할 근거는 없어요.

설치 전 준비

  • 공식 배포 대상은 Windows x64, macOS Apple Silicon·Intel예요. 정확한 최소 Windows/macOS 버전은 이번 자료에서 확정하지 않았어요. Linux는 README에서 로드맵으로 안내하며 Linux 셸용 명령 설명이 있다고 Linux 브라우저가 출시됐다는 뜻은 아니에요.
  • 브라우저 설치와 첫 실행 설정 완료, ego-browser 명령 등록, 스킬을 읽는 에이전트가 필요해요. 앱의 ego-browser nodejs 실행 경로를 쓰는 일반 사용과 소스 개발 환경을 구분해요. SDK를 직접 빌드할 때 package.json의 Node.js >=22와 개발 의존성이 요구돼요.
  • 에이전트 명령이 ego lite가 설치된 같은 컴퓨터에서 실행되거나 제품이 지원하는 공식 호스트 연결 경로가 있어야 해요. 클라우드·컨테이너 안에 스킬만 복사한다고 노트북 브라우저에 연결되지는 않습니다.
  • 호스트에서 필요한 명령을 실행할 현재 권한은 별도 조건이에요. 승인 프롬프트를 없애는 옵션과 실제 호스트 실행 권한은 달라요. 이 분석에서는 전체 접근·샌드박스 해제·원격 연결·새 권한 부여를 수행하지 않았어요.
  • 공식 앱: Windows x64, macOS Intel·Apple Silicon; OS 최소 버전 미확인
  • Linux 브라우저·Linux headless는 현재 README상 로드맵/요청 단계
  • 로컬 셸 실행 가능한 Codex·Claude Code·Cursor·기타 지원 에이전트; 원격 실행은 공식 호스트 브리지 별도
  • SDK 소스 개발 Node.js >=22; 일반 앱·스킬·SDK 버전은 별도 관리

설치 방법

1. 공식 앱과 운영체제 선택

공식 홈페이지에서 OS·CPU에 맞는 설치 파일을 선택하는 문서상 절차예요. Windows는 사용자가 설치 파일을 실행하고 앱을 열며, macOS는 해당 DMG를 사용해요. 저장소를 git clone하는 작업만으로 브라우저 앱이 설치되지는 않습니다. 이번 분석에서는 다운로드하거나 설치하지 않았어요.

공식 자료 확인

2. 초기 설정과 데이터 가져오기

첫 실행 안내를 사용자가 완료해요. 다른 브라우저의 로그인·쿠키·확장·북마크 가져오기는 필요한 경우에만 선택해요. 가져오기와 스킬 설치, CLI 등록은 서로 다른 단계이며 비밀번호나 인증 코드를 에이전트에게 보낼 필요는 없어요. 기존 노트북은 설치와 초기 설정을 완료했다는 전달 관측이 있으므로 여기서 다시 설치할 이유를 확인한 것은 아니에요.

공식 자료 확인

3. 설치 후 명령 인식 확인 조건

Windows의 PATH 변경은 이후에 시작한 프로세스에 반영돼요. 새 터미널뿐 아니라 이미 실행 중인 에이전트 앱 전체를 다시 시작해야 새 스킬·명령을 읽을 수 있다는 공식 안내예요. 아래는 동일한 에이전트 실행 환경에서 확인할 문서상 예시이며 이번 작업에서는 실행하지 않았어요.

Get-Command ego-browser
ego-browser skill

공식 자료 확인

4. 스킬만 추가하는 선택 경로

공식 README는 npx skills add citrolabs/ego-lite를 별도 스킬 설치 경로로 제시해요. 이는 브라우저 본체 설치·온보딩·호스트 실행 연결을 대신하지 않습니다. 앱이 이미 등록한 스킬과 중복 설치하거나 사용자 파일을 임의로 덮어쓰지 않아야 해요. 이번 작업에서는 실행하지 않았어요.

공식 자료 확인

사용 방법

  • 에이전트에 ego-browser 스킬을 선택하고 먼저 허용 범위를 말해요. 예: ‘ego-browser로 지정한 공개 페이지의 제목만 확인해줘. 로그인·클릭·변경 작업은 하지 마.’ 슬래시 메뉴를 지원하면 /ego-browser를 선택할 수 있지만 메뉴가 없다는 사실만으로 스킬 사용이 불가능한 것은 아니에요.
  • 에이전트는 설치된 런타임의 가이드를 읽고, 승인된 새 웹 작업이라면 목표당 하나의 TaskSpace를 만든 뒤 기본 p1 페이지를 재사용해요. 기존 Space를 대상으로 하려면 목록의 숫자 id로 대상을 확인해야 하며 이름만으로 다른 사용자 Space를 임의로 가져오면 안 돼요.
  • 페이지 관찰 후 Snapshot의 ref 또는 공식 선택자로 동작하고, 실제 결과가 나타났는지 다시 확인해요. 명령이 정상 반환됐다는 사실과 화면에서 업무 결과가 확인됐다는 사실은 구분해요.
  • 로그인·기기 확인·권한 대화상자처럼 사용자가 필요한 단계에서는 같은 Space를 사용자에게 넘겨줍니다. 사용자가 완료했다고 알려 준 뒤에만 허용된 흐름으로 이어갑니다. 계정 비밀값이나 전체 탭 목록을 수집할 필요는 없어요.
  • 다음 실행은 새 Node 프로세스이므로 JavaScript 변수는 유지되지 않습니다. 같은 작업의 숫자 Space id와 Page 라벨을 재사용해요. 종료 시 finish는 Page 라벨을 끝내며, keep으로 남긴 탭도 이후에 같은 라벨로 계속 제어할 수 있다는 뜻이 아니에요. 일반 웹 소개의 ‘결과 탭 유지’ 설명보다 설치된 버전 가이드의 keep·handoff 조건을 확인해야 해요.

에이전트 연동

스킬 로딩과 CLI 실행은 별개예요

에이전트가 ~/.agents/skills/ego-browser/SKILL.md 등 지원 경로의 스킬을 읽어야 하고, 실제 명령은 브라우저가 설치된 컴퓨터에서 실행되어야 해요. 공식 Codex 문서는 앱 재시작 후 스킬 선택을 안내해요. 사용자 설치 스킬은 앱이 덮어쓰지 않는 계약이므로 파일이 남아 있다고 매번 최신 API 안내까지 동일하다는 보장은 없어요.

공식 자료 확인

권한이 허용된 뒤 사용하는 실행 방식

가이드는 ego-browser nodejs가 JavaScript 스크립트를 받는다고 설명해요. Windows PowerShell 5.1은 긴 -e 문자열의 따옴표와 비 ASCII 문자를 손상할 수 있어 UTF-8 .mjs 파일과 절대 file:/// 경로로 불러오는 방식을 안내해요. 셸의 작업 디렉터리·환경변수가 그대로 전달된다고 가정하지 않습니다. 여기서는 실행 파일이나 스크립트를 구동하지 않았어요.

공식 자료 확인

읽기 연결과 탭 제어를 단계적으로 구분해요

아래는 이미 허용된 읽기 연결에서 개인 이름·URL·탭 제목을 출력하지 않고 Space 수만 확인하는 문서 API의 최소 예예요. taskSpace 생성·claim·탐색·클릭이 포함된 제어 시험과 달라요. 같은 컴퓨터의 브리지 응답이 있어도 목록이 0이면 기존 탭 제어가 검증된 것은 아니에요. 이번 분석에서 이 예를 실행하지 않았어요.

console.log({ spaceCount: (await listTaskSpaces()).length });

공식 자료 확인

탭 노출과 소유권

공식 네이티브 계약의 listTaskSpaces는 브리지에 노출된 에이전트 Space와 일반 사용자 Space를 읽기 전용으로 나열해요. 이 결과는 탭 목록이 아니에요. 승인받은 작업의 task.pages는 관리 Page, task.tabs는 해당 Space의 모든 탭을 나타내며 라벨 없는 탭은 제어 전에 adopt가 필요해요. 사용자 Space를 claim하는 작업은 소유권 변경이므로 단순 조회에 포함하지 않습니다.

공식 자료 확인

새 작업의 API 흐름 — 설명용 예시

아래 예시는 새 Space 생성·공개 페이지 탐색·제목 확인·정상 종료의 연결 관계를 보여 줍니다. 읽기 연결 확인만 하는 코드가 아니므로 별도 승인된 브라우저 작업에 해당하며 이번에 실행하지 않았어요. 실패·사용자 제어 상황에서는 뒤의 종료 코드를 무조건 이어 실행하지 않고 가이드의 중단·인계 절차를 따릅니다.

const task = await taskSpace('public-check');
const page = task.page('p1');
await page.goto('https://example.com');
console.log(await page.title());
await task.finish({ keep: [] });

공식 자료 확인

프로필과 저장된 로그인

새 Space 생성 시 선택한 프로필이 로그인·쿠키 환경을 결정해요. 이미 있는 Space의 프로필을 재개 호출로 바꾸는 API가 아니에요. 가이드는 사용자가 특정 프로필을 요구하지 않으면 프로필을 열거·선택하지 말라고 구분해요. 브라우저에 저장한 비밀번호가 있다는 사용자 진술만으로 해당 사이트의 자동완성 성공을 확정할 수 없어요.

공식 자료 확인

비용과 API 키

공식 README는 브라우저를 무료 별도 다운로드로 안내하고 저장소 자체 사용에 전용 모델 API 키를 요구하지 않습니다. 그러나 함께 쓰는 Codex·Claude Code·다른 모델의 구독 또는 API 호출 비용은 별도예요. 페이지 내용을 외부 AI에 전달하면 해당 제공자의 처리·보관 조건도 적용될 수 있어요. 클라우드 모델 대신 로컬 모델을 쓰는 조합은 호스트 지원과 기기 자원이 별도 필요하며 이 작업에서 구성하지 않았어요. 유료 AI 서비스가 무료가 되거나 모든 사이트의 자동화가 허용된다는 뜻은 아니에요.

라이선스

루트 LICENSE는 MIT(2026 CitroLabs)로 이 공개 저장소의 코드·문서에 적용돼요. README는 ego lite 브라우저 본체를 ‘별도의 무료 다운로드’로 구분해요. 따라서 저장소의 MIT를 브라우저 바이너리 전체·Chromium 의존성·서비스 약관의 동일 라이선스로 확대 해석하지 않습니다. 실제 앱 배포 약관·제3자 고지를 이번에 전부 검토하지 않았으며 MIT에는 보증이 없어요.

주의사항과 알려진 이슈

  • 로그인 상태 재사용은 계정 권한으로 업무 변경까지 가능한 기능이에요. 읽기·입력·게시·결제·삭제 등의 허용 범위를 먼저 정하고 사용자 승인 없이 작업 범위를 넓히지 않아야 해요. Space 분리는 운영 편의를 위한 작업 분리이며 개인 정보나 파일 접근을 완전히 차단하는 보안 샌드박스 보증으로 보지 않습니다.
  • README는 브라우저 데이터가 기기에 남는다고 설명하지만 에이전트에게 전달한 Snapshot·추출 텍스트·화면에는 업무 데이터가 포함될 수 있어요. 외부 모델을 쓰는 경우 ‘브라우저 로컬 저장’과 ‘AI 입력의 외부 전송’을 구분하고 쿠키·토큰·비밀번호·전체 개인 탭 목록을 진단 출력으로 남기지 않습니다.
  • 일부 Codex 소개 문서는 Full access나 승인·샌드박스 우회 옵션을 안내하지만, 자체 Harness 문서는 수동 명령 승인과 필요한 호스트 명령만 허용하는 좁은 정책도 구분해요. 전면 권한 해제가 항상 연결의 필수 조건이라는 결론으로 옮기지 않습니다. 이번 작업에서는 어떠한 권한·보안 설정도 바꾸지 않았어요.
  • 오래된 전역 함수 예제와 현재 TaskSpace/Page 가이드를 섞으면 탭 라벨·종료 동작을 오해할 수 있어요. guide 버전과 브라우저 버전을 별도로 확인하고, 설치 버전이 출력하는 가이드를 우선 대조해야 해요. source override나 debug SDK가 있으면 출력 안내와 실제 SDK가 다른지 확인할 별도 개발 검증이 필요해요.
  • 스크린샷 성공과 DOM 조회 성공은 다른 경로예요. Windows에서 최소화 상태 캡처 오류·복원 뒤 간헐적 캡처 시간 초과가 공개 이슈로 보고됐어요. DOM이 읽혀도 시각 검증 완료로 표시하지 않으며, 반복적으로 창을 전면에 띄우거나 새 브라우저를 열어 실패를 회피하는 기본 절차로 삼지 않습니다.
  • 별도 사이트의 CAPTCHA·Cloudflare·조직 로그인·저장 비밀번호 자동완성은 브라우저 설치와 독립된 제약일 수 있어요. 자동 제어가 막혔다고 사용자 비밀번호를 추출하거나 다른 계정·브라우저로 우회하지 않습니다.
  • 제작사의 속도·토큰·성공률 비교는 특정 벤치마크 결과예요. 실제 업무 사이트·모델·확장·페이지 구성·동시 작업 수의 성능을 이번 분석에서 측정하지 않았어요.

#594 이전 TaskSpace가 SDK·UI에서 보이지 않는 Windows 보고

노트북의 빈 목록과 동일 원인인지 미확인. 네이티브 수명·브리지 가시성 계약을 질문하는 열린 보고이며 조회 시 댓글 0개였습니다.

#573 Windows 캡처 실패와 전면 창 복구의 한계

최소화 오류와 복원 뒤 간헐적 CDP 캡처 시간 초과를 구분한 사용자 보고예요. DOM 읽기 성공을 캡처 성공으로 간주할 수 없고 이번에 재현하지 않았어요.

#609 저장된 로그인 자동완성의 에이전트 사용 실패 보고

Windows 0.6.1.13·가이드 2.1.0에서 입력 필드가 채워지지 않았다는 보고예요. 계정·프로필 매칭과 실제 네이티브 선택기 존재가 검증된 것은 아니며 저장소 결함으로 확정하지 않습니다.

v2.1.0 공식 통합 스킬 릴리스

2026-10-16 게시, ego-browser-v2.1.0.zip. macOS/Windows 브라우저 설치 파일의 버전이나 동일 바이너리임을 증명하는 릴리스가 아니에요.

현재까지 전달받은 관측

이번 작업의 전달 기록에는 노트북에 ego lite 0.6.1.13 설치·초기 설정 완료, 진입 스킬 2.1.0 파일 존재, 등록 CLI 발견, 허용된 읽기 연결 응답이 있어요. 작업공간 조회는 두 번 모두 0개였고 탭 인식·실제 제어는 미검증이에요. 이 페이지 작성자가 해당 장치를 다시 검사한 결과는 아니에요. 다른 PC의 설치 상태나 사용자 계정·탭 내용은 조사하지 않았어요.

1. ‘0개’가 의미하는 범위를 먼저 제한해요

SDK는 native 결과의 taskSpaces 배열을 정규화하고 식별할 값(taskId/name/id)이 없는 행을 버립니다. 배열 자체가 없는 잘못된 응답은 오류를 냅니다. 따라서 []는 브리지가 빈 목록을 반환했거나 행이 필터링됐을 가능성을 구분하지 못하며, 사용자의 전체 브라우저 탭이 0개라는 증거가 아니에요. 원시 결과를 이번에 수집하지 않아 어느 경로였는지 미확인이에요.

공식 자료 확인

2. 같은 실행 위치·설치 경로인지 확인할 순서

문서 기준으로는 브라우저가 설치된 같은 노트북에서 명령이 실행되는지, 온보딩 후 시작한 프로세스가 등록 CLI와 스킬을 읽는지 확인하는 순서예요. 명령 경로 발견만으로 호스트 연결이나 올바른 브라우저 실행 인스턴스를 증명하지는 않습니다. 현재는 CLI 발견과 읽기 응답까지 전달됐으므로 이를 ‘미설치’로 되돌려 단정하거나 메인 PC를 추가 검사할 근거는 없어요.

공식 자료 확인

3. 사용자 UI의 Space 존재와 SDK 노출을 구분해요

기존 Space가 실제로 생성된 적이 있는지, 사용자가 현재 보고 있는 Space 관리 목록과 같은 대상을 찾는지 확인할 수 있어요. 일반 페이지 열기만으로 에이전트용 Space가 생성됐다고 가정하지 않습니다. 공식 문서는 브리지에 사용 가능한 사용자·에이전트 Space를 나열한다고만 설명하며, 모든 창·프로필·브라우저 세대의 가시성 세부 조건은 이번 소스에서 확정하지 못했어요. 이런 차이는 가능한 확인 항목이지 현상의 확정 원인이 아니에요.

공식 자료 확인

4. Space 수명과 종료 기록을 별도로 봅니다

finish·close로 작업이 종료됐는지, 사용자에게 넘긴 상태인지, 브라우저 재시작 등 연속성 변화가 있었는지 알려진 기록만 확인해요. Page ledger의 보존 주석은 한 번의 ego lite 실행 안에서 Agent 라운드·Node 서비스 재시작을 다루며 앱 재시작 이후 영구 보존을 보장하지 않습니다. Node 프로세스가 바뀌었다는 이유만으로 Space가 반드시 사라진다고도 단정할 수 없어요.

공식 자료 확인

5. 유사 이슈는 원인 확정 자료가 아니에요

열린 #594는 Windows 0.6.1.13·스킬 2.1.0 환경에서 이전 Space가 나중에 SDK와 UI에 보이지 않은 사례를 보고해요. 2026-10-29 조회 시 댓글은 없었으며 유지관리자의 원인 확정이나 수정 검증이 없어요. 노트북에서 두 번 빈 결과가 나온 것과 증상이 일부 비슷해도 같은 결함이라고 단정하지 않습니다.

공식 자료 확인

6. 현재 권한에서 멈출 지점과 다음 검증

조회가 계속 0이라는 이유로 새 Space 생성, 사용자 Space claim, 프로필 전환, 브라우저 재시작, 권한 확대를 자동 수행하지 않습니다. 실제 제어 준비 완료 판정에는 사용자가 허용한 같은 호스트·Space에서 공개 페이지의 제목과 결과를 확인하는 별도 제어 시험이 필요하지만 이번 작업은 분석만 했어요. 이미 두 번 얻은 빈 결과를 추가 반복하지 않았어요.

Cloudflare 403과 혼동하지 않습니다

클라우드 로그인 403은 작업공간 목록 0의 원인으로 확인되지 않았고 ego 설치로 해결된다고 볼 근거도 없어요. 접근 거부를 다른 브라우저로 우회하거나 인증·보호 장치를 약화하는 절차는 제공하지 않습니다. 인증이 필요한 작업은 승인된 사이트·작업 범위에서 사용자가 직접 처리하고, 허용되지 않은 연결은 중단해야 해요.

확인 범위

확인 날짜: 2026-10-29

확인 커밋: aecc5831fc5a9ea01a078b632185992a3a7ac448

확인한 범위: 공식 main 커밋과 README·진입 SKILL·버전별 사용 가이드·설치 안내·package.json·네이티브 브리지 계약·helpers의 목록 정규화와 Space 선택·Page 수명 코드·ledger·Codex 플러그인·MIT·릴리스·관련 공개 이슈, 공식 Codex/자체 Harness/Space/설치 문서를 정적으로 대조했어요. 기존 10개 자료는 재분석하지 않았어요.

확인 한계: 이번 분석에서 ego·CLI·설치 스크립트를 실행하지 않았고 브라우저 조작·설정 변경·프로필 열거·로그인·다운로드·키 발급·권한 확대·다른 PC 접근을 수행하지 않았어요. 노트북 상태는 전달된 관측만 반영했어요. 공개 source와 실제 설치 SDK·네이티브 브라우저의 동일성, Space 0의 원인, 탭 제어·화면 캡처·호환성·보안·성능은 직접 검증하지 않았어요. 공식 웹 문서는 고정 커밋이 없는 확인일 기준 자료이며 버전별 가이드와 차이를 함께 명시했어요.

출처

Similar Posts

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다