ego(lite) — 나와 AI 에이전트가
함께 쓰는 브라우저
ego(lite)는 내가 평소처럼 인터넷을 쓰는 동안, AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex 등)가 같은 브라우저 안의 자기 공간에서 웹 작업을 대신 해 주는 브라우저입니다. Chrome과 같은 뿌리인 Chromium(크로미엄 — Chrome의 바탕이 되는 공개 브라우저 엔진)으로 만들었고, Citro Labs가 만듭니다. 조사, 양식 채우기, 웹사이트에서 자료 모으기, 웹 앱 시험 같은 일을 맡길 수 있습니다.
먼저 알아 두면 좋은 용어
가이드 전체에서 자주 나오는 말입니다. ⭐ 표시한 8개만 알아도 대부분 따라갈 수 있습니다. 각 장에서도 처음 나올 때 괄호로 다시 풉니다.
| 용어 | 쉬운 풀이 |
|---|---|
| ⭐ AI 에이전트 | 사람 대신 명령을 실행하며 일을 해 주는 AI 프로그램. 예: Claude Code, Codex, Cursor. ego(lite)에는 에이전트가 들어 있지 않고, 내가 쓰는 에이전트를 연결해서 씁니다. |
| ⭐ ego(lite) | 나와 에이전트가 함께 쓰는 브라우저. 주소창·탭·북마크·확장 프로그램이 Chrome처럼 동작합니다. |
| ⭐ Space | 스페이스. ego(lite) 안에 에이전트가 일하도록 따로 마련한 작업 공간. 자기 탭을 따로 가지며, 내 탭이나 마우스·키보드를 빼앗지 않습니다. |
| ⭐ 스냅샷 | Snapshot. 웹 페이지를 에이전트가 읽기 좋게 짧은 글로 옮긴 것. 페이지 제목, 보이는 글, 누를 수 있는 단추와 입력 칸이 정리되어 있습니다. |
| ⭐ 번호표 (@N) | 스냅샷에서 단추·입력 칸·링크마다 붙는 임시 번호. 에이전트는 “@5를 눌러라”처럼 번호로 동작합니다. 페이지가 바뀌면 번호도 새로 받습니다. |
| ⭐ ego-browser | 에이전트가 ego(lite)를 조종할 때 쓰는 명령 도구. 같은 이름의 스킬로 에이전트에 설치됩니다. |
| ⭐ 스킬 | Skill. 에이전트에게 “이 도구는 이렇게 써라” 하고 알려 주는 사용 설명서 묶음. 대화창에 /ego-browser를 입력해 불러옵니다. |
| ⭐ 넘겨받기 | 에이전트가 못 하는 단계(로그인 확인, 인증 번호, 결제 확인 등)를 내가 그 Space에 들어가 직접 처리하는 것. 끝나면 에이전트가 이어서 합니다. |
용어 20개 더 보기 — 읽다가 모르는 말이 나오면 여기서 찾으세요
| 용어 | 쉬운 풀이 |
|---|---|
| 브라우저 | 웹사이트를 보는 프로그램. Chrome, Safari, Edge 등. |
| Chromium | Chrome의 바탕이 되는 공개 브라우저 엔진. ego(lite)는 이것을 고쳐서 만들었습니다. |
| 쿠키 · 로그인 세션 | “이 사람은 이미 로그인했다”는 것을 브라우저가 기억해 두는 정보. 이것이 있으면 다시 로그인하지 않아도 됩니다. |
| 프로필 | 브라우저 안의 사용자 묶음. 북마크·비밀번호·확장 프로그램·로그인 정보가 프로필마다 따로 저장됩니다. |
| 확장 프로그램 | 브라우저에 기능을 더하는 작은 프로그램. 광고 차단, 비밀번호 관리 등. |
| 데이터 가져오기 | Chrome 등 쓰던 브라우저의 로그인·북마크·비밀번호·확장 프로그램을 ego(lite)로 옮기는 것. |
| 첫 실행 설정 | onboarding. ego(lite)를 처음 열 때 한 번 거치는 설정 과정. 이때 스킬 설치와 데이터 가져오기가 이루어집니다. |
| 터미널 · 셸 명령 | 글자로 명령을 입력해 컴퓨터를 다루는 창과, 거기 입력하는 명령. 에이전트는 이 명령을 실행해 ego-browser를 부릅니다. |
| TUI | 터미널 안에서 글자로 쓰는 화면. 같은 에이전트라도 데스크톱 앱과 TUI 두 가지가 있는 경우가 많습니다. |
| 승인 없이 실행 | 에이전트가 명령을 실행할 때마다 묻지 않도록 권한을 넓혀 주는 설정. 에이전트마다 이름이 다릅니다(Bypass permissions, Full access 등). |
| 샌드박스 | 프로그램이 컴퓨터의 다른 부분을 건드리지 못하게 가둬 두는 격리된 실행 칸. |
| 하니스 | Agent Harness. AI 모델에게 도구를 쥐여 주고 돌리는 에이전트 프로그램. |
| 토큰 | AI가 읽고 쓰는 글의 양을 세는 단위. 많이 읽을수록 느려지고 비용이 늡니다. |
| 헤드리스 | headless. 화면에 창을 띄우지 않고 뒤에서만 도는 브라우저. ego(lite)의 Space는 헤드리스가 아니라 눈으로 볼 수 있습니다. |
| CAPTCHA | “사람인지 확인”하는 그림·퍼즐 검사. |
| 2FA · SSO | 2FA는 비밀번호 외에 문자·앱 코드로 한 번 더 확인하는 2단계 인증. SSO는 회사 계정 하나로 여러 서비스에 로그인하는 방식. |
| HTML · DOM | 웹 페이지를 이루는 원본 코드와, 브라우저가 그것을 읽어 만든 페이지 구조. |
| iframe · shadow DOM | 페이지 안에 끼워 넣은 다른 페이지(iframe)와, 바깥에서 잘 보이지 않게 감싼 부품(shadow DOM). 결제 창·채팅 위젯에 흔합니다. |
| CSS 선택자 | 페이지 코드에서 특정 요소를 가리키는 주소 표기. 사이트가 코드를 바꾸면 쉽게 깨집니다. |
| 로컬 모델 | 인터넷 서비스가 아니라 내 컴퓨터에서 직접 돌리는 AI 모델. |
전체 그림 — 누가 무엇을 하나
등장인물은 넷입니다. 나, 내가 쓰는 에이전트, 둘을 잇는 ego-browser, 그리고 ego(lite) 브라우저입니다. 나는 에이전트에게 말로 일을 맡기고, 에이전트는 ego-browser를 통해 ego(lite) 안의 자기 Space에서 페이지를 열고 읽고 누릅니다. 그동안 나는 내 탭에서 하던 일을 계속합니다.
왜 이런 구조가 필요할까요? 에이전트에게 브라우저를 맡기는 흔한 방법 두 가지에는 각각 불편이 있습니다.
핵심 개념 네 가지
ego(lite)를 이해하는 데 필요한 개념은 넷입니다. 각각 한 장씩 따로 설명합니다.
① Space — 어디서 일하나
에이전트가 작업하는 전용 공간입니다. 새 창도, 두 번째 프로필도, 화면 없는 브라우저도 아닙니다. 같은 ego(lite) 안에서 돌아가며, 보통 작업 하나에 하나씩 여러 개를 동시에 돌릴 수 있습니다. → 2장
② 스냅샷 — 어떻게 읽나
에이전트는 페이지 원본 코드 대신 짧게 정리된 글을 읽습니다. 누를 수 있는 요소마다 번호표(@N)가 붙어 있어, 그 번호로 누르고 입력합니다. → 3장
③ ego-browser — 어떻게 조종하나
에이전트가 짧은 스크립트를 쓰면, “페이지 열기 → 읽기 → 누르기 → 결과 보고”를 한 번의 호출로 실행합니다. 주고받는 횟수가 줄어 작업이 빨리 끝납니다. → 4장
④ 넘겨받기 — 사람이 필요할 때
인증 번호, QR 로그인, 결제 확인처럼 사람만 할 수 있는 단계에서는 에이전트가 멈추고 나를 부릅니다. 내가 그 Space에서 처리하면 에이전트가 이어 갑니다. → 2장
작업 하나가 처음부터 끝까지 흘러가는 모습은 이렇습니다.
이 가이드의 지도
미리 알아 둘 사실
| 항목 | 내용 |
|---|---|
| 가격 | 내려받기와 사용이 무료입니다. 구독, 작업당 요금, 브라우저 사용 시간 요금이 없습니다. 다만 내가 쓰는 에이전트와 AI 모델 비용은 지금처럼 내가 냅니다. |
| 계정 | ego(lite)를 쓰는 데 계정이나 이메일 주소가 필요 없습니다. |
| 지원 환경 | macOS용이 기준입니다. Windows용은 베타로 내려받을 수 있고(Windows 빠른 시작 문서 기준), Linux용은 예정입니다. 제품 소개 문서에는 아직 “Windows·Linux 예정”이라고 적혀 있습니다. |
| 에이전트 | 셸 명령(터미널에 입력하는 명령)을 실행할 수 있는 에이전트면 연결할 수 있습니다. 문서가 안내하는 것은 Claude Code, Codex, Cursor, OpenCode, WorkBuddy, Hermes Agent, OpenClaw, DeepSeek Harness, 그리고 직접 만든 에이전트입니다. |
| 데이터 | ego(lite)는 내 컴퓨터에서 돕니다. Chrome에서 가져온 비밀번호·쿠키·방문 기록·북마크·확장 프로그램·프로필은 Chrome에서처럼 내 컴퓨터에 저장됩니다. 에이전트가 페이지를 다룰 때는 그 페이지 내용이 에이전트가 쓰는 AI 모델로 전달됩니다. |
| 하지 않는 것 | CAPTCHA나 사이트의 보안 확인을 우회하지 않습니다. 에이전트가 어떤 작업을 해도 되는지도 ego(lite)가 정하지 않습니다 — 내가 고른 에이전트와 내가 정한 한계에 달려 있습니다. |
| 곧 제공 예정 | 성공한 작업 방법을 사이트별로 저장해 다음에 재사용하는 “경험 쌓기” 기능(제한 베타)과 Linux용. |
- ego(lite)는 나와 AI 에이전트가 함께 쓰는 Chromium 기반 브라우저이고, 무료이며 계정 없이 씁니다.
- 에이전트는 Space라는 전용 공간에서 일하므로 내 탭·마우스·키보드를 빼앗지 않습니다.
- 에이전트는 페이지를 스냅샷(짧은 글 + 번호표)으로 읽고, ego-browser로 여러 동작을 한 번에 실행합니다.
- 사람만 할 수 있는 단계에서는 에이전트가 멈추고, 내가 넘겨받아 처리합니다.
- 에이전트와 AI 모델은 내가 고르고, 그 비용도 내가 냅니다. ego(lite)는 브라우저와 조종 도구를 제공합니다.
출처: lite.ego.app (첫 화면) · lite.ego.app/document/en/docs/product-introduce · lite.ego.app/document/en/docs/windows/quick-start (Windows 베타 내려받기) · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
시작하기 — 설치부터 첫 작업까지
ego(lite)를 설치하고, 내가 쓰는 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex 등)를 연결해, 첫 웹 작업을 맡기고 지켜보는 데까지 걸리는 시간은 약 2분입니다. 이 장은 그 과정을 순서대로 따라가며, 단계마다 “왜 이렇게 하는지”를 함께 설명합니다. 예시 에이전트는 원문과 같이 Codex입니다.
- macOS에 ego(lite)를 설치하고 첫 실행 설정을 마치는 법
- 쓰던 브라우저에서 무엇이 옮겨지고, 그 데이터가 어디에 남는지
- 에이전트 대화창에서
/ego-browser로 스킬을 켜는 법과, 권한을 넓혀 줘야 하는 이유 - 첫 작업을 맡기고, 에이전트가 일하는 Space를 들여다보고, 필요할 때 넘겨받는 법
- Windows(베타)에서 달라지는 점과, 그다음에 맡겨 볼 만한 일 여섯 분야
설치와 첫 실행 설정 → 에이전트 연결 → 첫 작업 맡기기 → 지켜보고 넘겨받기 순서로 읽으면 첫 작업을 끝낼 수 있습니다.
Windows를 쓴다면 이 장 뒤쪽의 「Windows(베타)에서 달라지는 점」도 함께 보세요. “🔧 개발자용 참고” 상자는 모두 접어 두고 읽어도 됩니다.
설치와 첫 실행 설정
전체 과정은 네 걸음입니다. 여기서는 첫 걸음인 설치를 다룹니다. 설명은 macOS 기준입니다.
설치는 여느 macOS 앱과 같습니다. 내려받기 단추는 ego(lite) 공식 문서(lite.ego.app)의 Quick start(빠른 시작) 쪽 맨 위에 있습니다.
- DMG 파일을 내려받아 엽니다Download for Mac(Mac용 내려받기) 단추로 DMG(macOS에서 앱을 담아 배포하는 설치 파일)를 받습니다.
- 안내에 따라 ego(lite) 아이콘을 더블클릭해 설치합니다화면에 나오는 안내를 그대로 따르면 됩니다.
- ego(lite)를 찾아 열고, 첫 실행 설정을 마칩니다첫 실행 설정(onboarding — 처음 열 때 한 번 거치는 설정 과정)에서 아래 두 가지가 이루어집니다.
첫 실행 때 ego(lite)는 두 가지 일을 합니다. 하나는 에이전트가 ego(lite)를 쓸 수 있게 준비하는 일이고, 다른 하나는 내가 쓰던 브라우저의 데이터를 가져올지 묻는 일입니다.
①에서 기록되는 스킬(Skill — 에이전트에게 “이 도구는 이렇게 써라” 하고 알려 주는 사용 설명서 묶음) 덕분에, 널리 쓰이는 에이전트 대부분은 따로 설치할 것 없이 곧바로 ego(lite)를 쓸 수 있습니다.
스킬이 기록되는 폴더
첫 실행 때 ego(lite)는 컴퓨터에 설치된 에이전트를 찾아, 그 에이전트들의 스킬 폴더에 ego-browser 스킬을 써 넣습니다. 원문이 밝힌 위치는 두 곳입니다.
~/.agents/skills
~/.claude/skills/
~는 내 홈 폴더(내 사용자 이름으로 된 기본 폴더)를 뜻합니다. 스킬이 무엇이고 어떻게 불려 오는지는 4장, 에이전트 목록에 스킬이 보이지 않을 때의 대처는 5장에서 다룹니다.
데이터 가져오기 — 쓰던 브라우저를 그대로 옮기기
데이터 가져오기는 Chrome 같은 쓰던 브라우저의 로그인 상태와 설정을 ego(lite)로 옮기는 일입니다. 첫 실행 설정 중에 ego(lite)가 가져올지 묻고, 브라우저를 고른 뒤 확인하면 끝납니다. 옮겨지는 것은 다음 다섯 묶음입니다.
왜 가져오나요? 로그인해야 보이는 사이트에서는 에이전트도 로그인된 상태여야 일할 수 있습니다. 데이터를 가져오면 이미 로그인해 둔 사이트가 ego(lite)에서도 로그인된 채로 열리고, 에이전트도 같은 로그인 상태를 이어받습니다. 원문은 Gmail, Notion, LinkedIn, 회사 내부 도구를 예로 들며, 작업할 때마다 다시 인증할 필요가 없다고 설명합니다.
| 궁금한 점 | 원문의 답 |
|---|---|
| 데이터는 어디에 남나 | 가져온 브라우저 데이터는 내 컴퓨터에 남고 내가 관리합니다. 북마크·비밀번호·쿠키·방문 기록은 Chrome에서처럼 내 컴퓨터에 저장되며, 무엇을 남길지는 내가 정하고 설정에서 관리하거나 지울 수 있습니다. 다만 에이전트가 어떤 페이지에서 일할 때 그 페이지의 내용은 내가 에이전트에 골라 둔 AI 모델로 보내집니다 — 7장. |
| Chrome 대신 써도 되나 | 됩니다. 주소창, 탭 그룹, 북마크, 프로필, 확장 프로그램, 내려받기, 시크릿 모드가 Chrome과 같은 방식으로 동작하므로 쓰던 습관을 바꿀 필요가 없습니다. 다른 점은 에이전트가 일하는 Space(스페이스 — 에이전트 전용 작업 공간)가 있다는 것입니다. |
| 가져오지 않으면 | 가져오기는 ego(lite)가 묻고 내가 정하는 선택 사항입니다. 가져오지 않고 ego(lite)에서 사이트에 직접 로그인해도 됩니다. 에이전트는 내가 ego(lite)에 로그인해 둔 사이트라면 어디서든 일할 수 있습니다(Windows 빠른 시작 문서의 안내 — Windows(베타)에서 달라지는 점). |
원문마다 조금씩 다른 “옮겨지는 것” 목록
| 원문 위치 | 적힌 항목 |
|---|---|
| 빠른 시작 — 첫 실행 안내 | sessions(로그인 세션), bookmarks(북마크), passwords(비밀번호), extensions(확장 프로그램) |
| 빠른 시작 — 키체인 안내 | login state(로그인 상태), cookies(쿠키), extensions(확장 프로그램), Chrome Profile(Chrome 프로필) |
| 첫 화면 자주 묻는 질문 | 쓰던 탭과 탭 그룹 / 북마크와 저장된 비밀번호 / 확장 프로그램 / 쿠키와 로그인 세션 / 브라우저 프로필 — “Chrome에서 클릭 한 번으로” |
| 첫 화면 개인정보 대목 | 북마크·비밀번호·쿠키·방문 기록은 Chrome에서처럼 내 컴퓨터에 저장 |
서로 어긋나는 내용은 아니고, 같은 것을 다른 말로 나눠 적은 것입니다. 빠른 시작은 “다른 브라우저”라고 넓게 말하고, 첫 화면은 Chrome을 기준으로 설명합니다. 개인정보에 관한 더 자세한 내용은 7장에 있습니다.
에이전트 연결 — /ego-browser 한 줄
ego(lite)는 내가 쓰는 에이전트를 연결해서 쓰는 브라우저입니다. 그러려면 에이전트에게 “ego(lite)를 쓰는 법”을 알려 줘야 하는데, 그 설명서가 ego-browser 스킬(스킬 = 에이전트에게 주는 사용 설명서 묶음)입니다. 스킬은 ego(lite)를 처음 열 때 이미 에이전트 쪽에 기록되어 있으므로, 내가 할 일은 불러오는 것 하나입니다.
에이전트의 대화 입력창에 아래처럼 입력하면 스킬이 켜집니다.
/ego-browser▍
입력창에 /ego-browser를 입력해 스킬을 켭니다. 실제 화면 모양은 에이전트마다 다릅니다.
다음 할 일 — 권한
에이전트에 권한 설정이 있다면 Full access(전체 접근)로 바꿔 두기를 원문은 권합니다. 이유는 바로 다음 왜 권한을 넓혀 줘야 하나에 있습니다.
Codex가 아니라면
Claude Code, Cursor, OpenCode 등은 스킬을 불러오는 방법과 권한 설정의 이름·위치가 조금씩 다릅니다. 에이전트별 방법은 5장에 모았습니다.
직접 만든 에이전트라면
직접 만든 에이전트 프로그램이나 내 컴퓨터에서 도는 로컬 모델로 쓰는 방법은 6장에서 다룹니다.
왜 권한을 넓혀 줘야 하나
에이전트는 권한이 좁게 잡혀 있으면 명령을 샌드박스(프로그램이 컴퓨터의 다른 부분을 건드리지 못하게 가둬 두는 격리된 실행 칸) 안에서만 실행합니다. 그런데 ego-browser 명령은 ego(lite)를 띄워야 하고, ego(lite)는 샌드박스 안이 아니라 내 컴퓨터에 설치된 앱입니다. 따라서 에이전트에게 “샌드박스 밖의 앱을 실행해도 된다”는 권한이 있어야 합니다.
그래서 원문은 에이전트에 권한 설정이 있다면 Full access로 두라고 권합니다. Codex에서도 이 설정을 해 두어야 ego-browser로 ego(lite)를 띄우고 작업을 실행할 수 있습니다. 이런 설정을 이 가이드에서는 통틀어 “승인 없이 실행(권한 넓히기)”이라고 부르며, 에이전트마다 화면에 보이는 이름이 다릅니다.
에이전트마다 다른 권한 설정 이름 (빠른 시작 “Go deeper” 목록)
| 에이전트 | 빠른 시작 문서의 한 줄 안내 | 자세히 |
|---|---|---|
| Claude Code | Cowork에서 Code로 바꾸고 bypass permissions(승인 건너뛰기)를 켠 뒤 ego-browser 실행 | 5장 |
| Codex | Full access(전체 접근)를 켜고 ego-browser를 불러와, 데스크톱 앱이나 TUI(터미널 안에서 글자로 쓰는 화면)에서 전체 흐름 실행 | 5장 |
| Cursor | ego-browser를 불러오고 Full access를 켠 뒤 브라우저 작업 실행 | 5장 |
| OpenCode | auto-approve permissions(권한 자동 승인)를 켜고 데스크톱 앱이나 TUI에서 사용 | 5장 |
| WorkBuddy | Full Access를 켜고 데스크톱 앱이나 터미널의 CodeBuddy Code에서 사용 | 5장 |
| Hermes Agent | bypass permissions를 켜고 데스크톱 앱이나 TUI에서 사용 | 5장 |
| OpenClaw | no-approval execution(승인 없는 실행)을 설정하고 macOS 앱이나 TUI에서 사용 | 5장 |
| DeepSeek Harness | Full access를 켜고 로컬 Web UI나 화면 없는 터미널에서 사용 | 5장 |
| 직접 만든 에이전트 | 명령이 어디서 실행되는지 확인하고, 필요할 때만 호스트 실행(ego(lite)가 설치된 바로 그 컴퓨터에서 명령을 실행하는 것)을 허용한 뒤 ego-browser 연결 | 6장 |
| 로컬 모델 | Ollama를 OpenCode에 연결해 로컬 모델로 ego(lite) 조종 | 6장 |
첫 작업 맡기기
준비물은 두 가지입니다. ego-browser 스킬이 켜져 있을 것(에이전트 연결), 그리고 권한이 Full access일 것(권한을 넓히는 이유). 둘이 갖춰졌으면 아래 한 줄짜리 프롬프트(에이전트에게 보내는 요청 글)를 에이전트 대화창에 붙여 넣고 Enter를 누릅니다.
Use ego-browser. Please open the blog pages of OpenAI and Anthropic, check if there is any noteworthy information, and quickly summarize the main points of the latest articles for me.
뜻: ego-browser를 써 줘. OpenAI와 Anthropic의 블로그 페이지를 열어서 눈여겨볼 소식이 있는지 확인하고, 최신 글들의 요점을 빠르게 요약해 줘.
그러면 에이전트는 ego(lite) 안에 새 Space(스페이스 — 에이전트 전용 작업 공간)를 만들고, 거기서 두 블로그를 읽은 뒤 요약을 돌려줍니다.
같은 과정을 한 단계씩 넘겨 보세요.
① 프롬프트를 붙여 넣고 Enter — 맨 앞의 Use ego-browser.는 “이 일에는 ego-browser를 써라”는 뜻입니다.
Use ego-browser. Please open the blog pages of OpenAI and Anthropic, …▍
② 에이전트가 ego(lite)에 새 Space를 만듭니다 — ego-browser 명령이 ego(lite)를 띄우고, 이 작업을 위한 Space를 엽니다. 내 탭은 그대로입니다.
③ 그 Space에서 두 블로그 페이지를 엽니다 — OpenAI 블로그와 Anthropic 블로그가 에이전트의 Space 안에서 열립니다.
④ 최신 글을 읽고 정리합니다 — 두 회사의 최신 글을 훑어 최근 소식과 요점을 추립니다. 궁금하면 이때 지켜보고 넘겨받기의 방법으로 들여다볼 수 있습니다.
⑤ 요약이 돌아옵니다 — 에이전트가 정리한 요약을 나에게 돌려주면 첫 작업이 끝난 것입니다.
지켜보고 넘겨받기
에이전트가 일하는 동안 무엇을 하고 있는지 궁금하면, ego(lite) 오른쪽 위의 Space 단추를 누릅니다. 그러면 Space(에이전트 전용 작업 공간)를 관리하는 Space management panel(Space 관리 패널)이 열립니다. 거기서 파란 빛이 도는 Space가 지금 에이전트가 일하고 있는 곳입니다.
파란 빛이 도는 Space를 눌러 들어가면 두 가지를 할 수 있습니다. 에이전트가 무엇을 하는지 보는 것, 그리고 에이전트가 혼자 못 하는 일을 내가 대신 처리해 주는 것(넘겨받기)입니다. 원문이 꼽는 “나를 부르는 때”는 셋입니다.
🔑 로그인이 필요할 때
사이트가 로그인을 요구하면 내가 그 Space에 들어가 직접 로그인합니다.
✅ 확인·인증이 필요할 때
본인 확인처럼 사람이 직접 해야 하는 단계를 내가 처리합니다.
👀 결과를 봐 줘야 할 때
에이전트가 낸 결과가 맞는지 내가 확인합니다.
왜 이렇게 만들었을까요? ego(lite)의 Space 구조에서는 에이전트가 자기 Space 안에서만 일합니다. 그래서 아무 창이나 불쑥 띄우지 않고, 내가 쓰는 탭을 가로채지도 않습니다. 원문이 그리는 모습은 이렇습니다. 에이전트는 뒤에서 조용히 자기 일을 하고, 로그인·확인·결과 검토처럼 내가 꼭 필요한 순간에만 나를 부릅니다. 그동안 나는 기사를 읽거나 친구에게 이메일을 쓰던 일을 끊기지 않고 이어 갑니다.
Windows(베타)에서 달라지는 점
Windows용 ego(lite)는 베타(정식 출시 전 시험판)로 내려받을 수 있습니다. 큰 흐름(설치 → 에이전트 연결 → 첫 작업 → 지켜보기)은 같고, 화면과 예시가 조금 다릅니다. Windows에 관해 이 가이드가 근거로 삼은 문서는 Windows 빠른 시작 한 쪽뿐이므로, 다른 장의 설명은 macOS 기준이며 Windows에서는 화면과 경로가 다를 수 있습니다.
| 단계 | macOS (앞에서 본 내용) | Windows (베타) |
|---|---|---|
| 설치 | DMG를 내려받아 열고 아이콘을 더블클릭 | Download for Windows (beta)로 받아 설치 프로그램을 실행하고, 화면 안내를 따른 뒤 ego(lite)를 열어 설정을 마침 |
| 데이터 가져오기 | 브라우저를 고르고 확인. 키체인 암호를 여러 번 물을 수 있음 | 설정 중 가져오기가 나오면 쓸 프로필을 고르고, 무엇이 복사되는지 살펴본 뒤 확인 |
| 스킬 켜기 | 대화창에 /ego-browser 입력 | 입력 칸에 /ego를 입력하고 스킬 목록에서 Ego Browser 선택 |
| 권한 (Codex) | Full access 권장 | 입력 칸 아래 권한 메뉴에서 Full access 선택. 없으면 Settings > General > Permissions(설정 > 일반 > 권한)에서 먼저 쓸 수 있게 함 |
| 첫 작업 예시 | OpenAI·Anthropic 블로그 요약 | Reddit 인기 글 하나를 찾아 표로 정리 |
Windows 문서의 첫 작업은 Reddit에서 글 하나를 조사하는 일입니다. 스킬을 선택한 뒤 아래 요청을 보냅니다.
Use ego-browser. Open Reddit and find a popular post from the past week. Open the post and return its title, subreddit, link, posting date, upvote count, comment count, and view count if Reddit shows one. Present the results in a small table. If a figure is not visible, mark it as "not shown" rather than guessing. Do not vote or comment.
뜻: ego-browser를 써 줘. Reddit을 열어 지난 한 주 사이의 인기 글 하나를 찾아 줘. 그 글을 열고 제목, 서브레딧(게시판), 링크, 올린 날짜, 추천 수, 댓글 수, 그리고 Reddit이 보여 준다면 조회 수를 알려 줘. 결과는 작은 표로 정리해 줘. 보이지 않는 수치는 짐작하지 말고 “not shown”(표시 안 됨)이라고 적어 줘. 추천을 누르거나 댓글을 달지는 마.
에이전트는 ego(lite)에 Space를 만들어 Reddit을 열고 글을 읽은 뒤, 출처 링크가 달린 표를 돌려줍니다. 이 프롬프트에는 처음부터 익혀 둘 만한 습관 세 가지가 들어 있습니다.
| 항목 | 값 |
|---|---|
| 제목 · 서브레딧 · 링크 | (페이지에 보이는 그대로) |
| 올린 날짜 · 추천 수 · 댓글 수 | (페이지에 보이는 그대로) |
| 조회 수 | not shown — 원문 녹화에서 Reddit이 조회 수를 보여 주지 않아 Codex가 이렇게 적었습니다 |
① 안 보이면 “not shown”
보이지 않는 값을 짐작해 채우지 말고 표시하게 합니다. 페이지에 닿지 못했거나 수치를 읽지 못했다면, 빈칸을 메우지 말고 무엇이 빠졌는지 말해 달라고 요청합니다.
② 하지 말 것을 적는다
“추천·댓글 금지”처럼, 읽기만 하는 작업이면 하면 안 되는 동작을 프롬프트에 분명히 적습니다.
③ 끝나면 실제 글과 대조
작업이 끝나면 표의 링크를 열어 실제 글과 비교합니다. 에이전트의 탭은 작업 뒤에도 Space에 남아 있어, 답의 근거가 된 페이지를 다시 볼 수 있습니다.
작업 중에 에이전트의 Space를 열면 에이전트가 연 페이지들이 보이고, 내 탭은 제자리에 그대로 있습니다. 사이트가 로그인이나 인증 코드처럼 나만 줄 수 있는 입력을 요구하면 그 단계만 넘겨받고, 끝나면 에이전트가 이어서 진행합니다.
Windows 문서의 세부 안내 — 가져오기 · 스킬이 안 보일 때 · 다른 에이전트
- 가져오기 중 권한 요청 — 다른 브라우저의 데이터에 접근해도 되는지 물으면, 요청 내용을 살펴보고 화면의 안내를 따릅니다. 가져오지 않고 ego(lite)에서 사이트에 직접 로그인해도 됩니다. 에이전트는 내가 ego(lite)에 로그인해 둔 사이트라면 어디서든 일할 수 있습니다.
- 어디서 에이전트를 여나 — ego(lite)가 설치된 바로 그 컴퓨터에서 로컬 Codex 세션을 시작합니다.
- Claude Code — 같은 방식으로 스킬 목록에서
ego-browser를 찾습니다. - 스킬이 목록에 없으면 — ego(lite) 설정을 끝까지 마치고, 에이전트를 닫았다가 다시 연 뒤 한 번 더 확인합니다.
- 다른 에이전트의 권한 — ego-browser를 실행하거나 ego(lite)를 열겠다는 요청이 뜨면 살펴보고, 실행이 막히면 권한을 조정합니다. Codex의 전체 권한 설정과, 같은 작업을 네 단계로 나눈 설명은 5장 Codex에 있습니다.
Windows 빠른 시작이 “더 보기”로 안내하는 문서는 다음과 같습니다.
| 문서 | Windows 문서의 소개 | 이 가이드 |
|---|---|---|
| Claude Code · Codex | 에이전트별 Windows 녹화 영상 | 5장 |
| OpenCode · WorkBuddy | Windows에서 도쿄 Airbnb 검색을 따라 하기 | 5장 |
| Hermes Agent | Windows의 Hermes Desktop에서 ego-browser를 불러와 브라우저 작업 실행 | 5장 |
| OpenClaw | 권한 설정과 Windows에서의 도쿄 Airbnb 검색 | 5장 |
| DeepSeek Harness | Windows에서 Full access를 켜고 ego-browser 쓰기 | 5장 |
| 직접 만든 에이전트 | 연결 요건 설명, Windows 예시는 Hermes | 6장 |
| 로컬 모델 | Ollama 설정과 로컬 Qwen으로 하는 브라우저 작업 | 6장 |
| What is ego(lite) · Space · Snapshot · ego-browser · Skills | 브라우저와 에이전트가 함께 일하는 방식, 에이전트의 페이지가 있는 곳, 페이지를 읽는 법, 브라우저 도구, 에이전트가 그 도구를 쓰게 되는 과정 | 소개 · 2장 · 3장 · 4장 |
그다음 해 볼 만한 일
블로그 요약은 출발점일 뿐입니다. 빠른 시작 문서는 ego(lite)로 할 수 있는 일을 여섯 분야로 나눠 소개합니다. 여러 분야에 되풀이해 나오는 말은 로그인이 필요한데 API로는 닿기 어려운 곳(API — 프로그램끼리 자료를 주고받는 공식 창구)입니다.
① 소셜 미디어
트윗에 답글 달기, 내 메모 내용으로 인용 트윗 쓰기, 게시물 초안을 써서 게시 대기 목록에 올려 두기, 반응 수치 모으기, 멘션(나를 언급한 글) 지켜보기, 계정 활동 가져오기. X, LinkedIn, Threads, Reddit, Instagram, Facebook을 지원합니다. 로그인이 필요한데 API로는 닿지 않는 자료에도 닿을 수 있습니다.
② 구직 · 채용
LinkedIn, Wellfound, YC startup jobs에서 채용 공고를 검색하고 거른 뒤, Apply를 눌러 ATS(채용 지원서를 받는 시스템 — AshbyHQ, Greenhouse, Lever, Workday)로 넘어가 이력서를 올리고 답안 초안을 채웁니다. 그리고 최종 제출 전에 멈춰 내 확인을 기다립니다.
③ 부동산 · 금융 · 쇼핑
Redfin, Zillow, Apartments.com의 매물을 내 조건으로 거르고, 사이트의 주택 담보 대출·감당 가능 금액 계산기를 돌려, 정리된 자료를 내 컴퓨터의 Markdown 파일(간단한 기호로 서식을 적는 글 파일)에 적습니다. Amazon 가격 비교와 Costco 대량 주문도 됩니다. API가 사실상 닫혀 있는 중개 회사(brokerage)의 관리 화면도 같은 방식으로 다룹니다.
④ 예약
항공편·호텔·식당 예약의 전체 흐름. 번거로운 양식을 내 실제 개인 정보로 자동으로 채우고, 결제 페이지까지 가서 멈춥니다.
⑤ SaaS 관리 화면
HubSpot, Salesforce, Notion, Airtable, Linear, Stripe, GA4, Search Console, Mixpanel 같은 SaaS(웹으로 쓰는 업무용 서비스)에서 되풀이하는 일 — 보고서 뽑기, 대시보드 새로 고침, 여러 항목 값 한꺼번에 고치기, 정해진 때에 보내기. 이런 서비스가 모든 기능을 API로 열어 두는 경우는 드물고, 누구나 자동화를 직접 짤 수 있는 것도 아닙니다.
⑥ 사내 도구
회사의 관리자 화면, 스테이징 환경(정식 공개 전 시험용 사이트), QA(품질 점검) 흐름. 다른 자동화 도구가 넘지 못하는 로그인 뒤의 페이지도, ego(lite)는 평소 쓰는 브라우저의 실제 로그인 상태를 이어받아 정문으로 들어갑니다.
②와 ④에서 눈여겨볼 것은 멈추는 지점입니다. 최종 제출이나 결제 같은 마지막 한 걸음 앞에서 에이전트가 멈춥니다.
Windows 문서는 같은 여섯 분야를 이렇게 적습니다
| 분야 | Windows 빠른 시작의 설명 |
|---|---|
| 소셜 미디어 | 게시물과 답글을 살펴보고, 반응 수치를 모으고, 내 계정의 정보로 답글 초안을 씁니다. 게시되기 전에 초안을 확인할 수 있습니다. |
| 구직 · 채용 | 조건에 맞는 채용 공고를 찾고, 지원 양식을 열고, 답안이나 올릴 파일을 준비합니다. 지원서를 제출하기 전에 멈추라고 요청하세요. |
| 부동산 · 금융 · 쇼핑 | 여러 사이트의 매물이나 가격을 비교하고, 페이지의 계산기를 돌려, 결과를 표나 내 컴퓨터의 파일로 모읍니다. 구매나 계정에 관한 동작은 직접 검토하세요. |
| 예약 | 항공편·호텔·식당을 찾아 선택지를 비교하고 반복되는 항목을 채웁니다. 예약이나 결제 확인이 필요한 곳에서 에이전트가 멈출 수 있습니다. |
| 업무 도구 | CRM(고객 관리 도구), 분석 대시보드, 프로젝트 도구 등 로그인해 쓰는 서비스에서 정보를 모읍니다. 정기 보고 때 내가 쓰는 것과 같은 페이지와 양식을 에이전트가 그대로 따라갑니다. |
| 사내 도구 | 관리자 페이지와 스테이징 사이트를 점검하고, QA 흐름을 돌려 보고, 로그인해야만 보이는 대시보드에서 자료를 모읍니다. |
빠른 시작이 안내하는 “더 깊이” 문서와 커뮤니티
| 문서 | 다루는 것 | 이 가이드 |
|---|---|---|
| ego-browser | 전체 도우미(helper) 목록, 페이지 안에서 도는 js(), 원시 CDP 접근 | 4장 |
| Space | Space가 만들어지고 사라지는 과정과 이름 규칙 | 2장 |
| Snapshot | 번호표(@N)와 loc= 선택자 | 3장 |
| 에이전트별 안내 | Claude Code, Codex, Cursor, OpenCode, WorkBuddy, Hermes Agent, OpenClaw, DeepSeek Harness, 직접 만든 에이전트, 로컬 모델 — 목록은 왜 권한을 넓혀 줘야 하나의 접힌 표 | 5장 · 6장 |
원문은 사용자들이 만든 효율적인(또는 그냥 재미있는) 작업 방식을 보고 싶다며, 요령을 나누거나 도움이 필요하면 Discord 커뮤니티(discord.gg/WudzhWjJ9z)로 오라고 안내합니다.
- macOS에서는 DMG를 받아 설치하고 첫 실행 설정을 마칩니다. 새로 설치해 첫 작업을 끝내기까지 약 2분입니다.
- 첫 실행 때 ego(lite)는 설치된 에이전트를 찾아 ego-browser 스킬을 기록하고, 쓰던 브라우저의 데이터를 가져올지 묻습니다.
- 가져오면 로그인 상태가 그대로 옮겨져 에이전트도 같은 로그인으로 일합니다. 데이터는 내 컴퓨터에 남고, macOS가 키체인 암호를 여러 번 물을 수 있습니다.
- 에이전트 대화창에
/ego-browser를 입력해 스킬을 켜고, 권한은 Full access로 둡니다. ego-browser가 샌드박스 밖의 앱인 ego(lite)를 띄워야 하기 때문입니다. - 첫 작업을 맡기면 에이전트가 새 Space에서 페이지를 열어 읽고 요약을 돌려줍니다.
- 오른쪽 위 Space 단추로 패널을 열면 파란 빛이 도는 Space가 에이전트가 일하는 곳입니다. 로그인·인증·결과 확인이 필요하면 들어가서 내가 처리합니다.
- Windows는 베타입니다.
/ego→ Ego Browser 선택, Reddit 조사 예시, 안 보이는 값은 “not shown”으로 적게 하는 원칙을 기억하세요.
출처: lite.ego.app/document/en/docs/quick-start · lite.ego.app/document/en/docs/windows/quick-start · lite.ego.app (첫 화면 — “Wherever you're logged in, your agent is too” 대목과 자주 묻는 질문의 Chrome 대체·데이터 가져오기 항목) · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
Space — 에이전트 전용 작업 공간
AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex, Cursor 등)에게 웹 작업을 맡기면, 에이전트는 내 화면이 아니라 Space(스페이스 — 에이전트 전용 작업 공간)에서 일합니다. 이 장에서는 Space가 무엇이고 무엇이 아닌지, 왜 이런 구조로 만들었는지, 나와 에이전트가 어떻게 번갈아 일하는지, 에이전트가 반드시 멈춰야 하는 순간은 언제인지를 차례로 살펴봅니다.
- Space가 “새 창”도 “두 번째 프로필”도 아닌 이유
- 브라우저를 작업마다 따로 띄우는 방식과 비교했을 때 무엇이 가벼운지
- Space를 써야 하는 작업과 일반 웹 검색으로 충분한 작업
- 일을 맡기고 → 지켜보고 → 넘겨받고 → 확인하는 6단계 흐름
- 로그인 상태가 어떻게 쓰이는지, 에이전트가 멈추고 나를 불러야 하는 4가지 상황
- 여러 작업을 동시에 맡길 때와, 작업이 끝난 뒤·ego(lite)를 껐다 켠 뒤 Space가 어떻게 남는지
- Space란 무엇인가 — 인 것과 아닌 것. 이 장의 바탕입니다.
- 나와 에이전트가 함께 일하는 흐름 — 6단계와 지켜보는 방법.
- 로그인 상태와 멈춰야 하는 순간 — 넘겨받기와 미리 경계 정하기.
Space란 무엇인가 — 인 것과 아닌 것
Space(스페이스)는 ego(lite)가 AI 에이전트(내 대신 일하는 AI 프로그램)를 위해 따로 마련한 병렬 작업 공간(병렬 — 내 탭과 나란히, 동시에 돌아간다는 뜻)입니다. 에이전트는 자기 Space 안에서 페이지를 열고, 읽고, 누르고, 양식을 채우고, 파일을 내려받습니다. 그동안 나는 내 탭에서 하던 일을 계속합니다. 양쪽은 하나의 ego(lite) 브라우저 프로세스(프로세스 — 실행 중인 프로그램 하나)를 함께 쓰지만 서로를 방해하지 않습니다.
원문은 Space를 “인 것”과 “아닌 것”으로 나누어 못 박아 둡니다. 헷갈리기 쉬운 부분이라, Space 문서의 목록에 제품 소개 문서의 설명을 보태어 옮깁니다.
✅ Space는 이런 것입니다
- 같은 ego(lite) 브라우저 프로세스 안에 있는 병렬 작업 공간
- 작업 하나마다 따로 주어지는 격리된 칸 — 자기 쿠키(로그인 상태 같은 것을 기억하는 정보)와 저장소를 가집니다
- Space마다 자기 탭이 있고, 모든 Space는 같은 ego(lite) 안에서 돕니다
❌ Space는 이런 것이 아닙니다
- 새 브라우저 창이나 새(두 번째) Chrome 프로필(북마크·로그인을 따로 담는 사용자 묶음)이 아닙니다
- 헤드리스 Chrome(화면 없이 뒤에서만 도는 브라우저)이나 화면 밖에서 그리는 방식이 아닙니다 — 눈으로 볼 수 있습니다
- 클라우드 브라우징 세션(남의 서버에서 도는 브라우저)이 아닙니다 — 내 컴퓨터의 ego(lite)에서 돕니다
Space는 ego(lite)에 처음부터 들어 있습니다. 따로 켜거나 설치할 것이 없고, ego(lite)를 설치하고 에이전트를 연결하면(1장) 바로 쓸 수 있습니다.
원문 용어 — BrowserContext, 그리고 스킬만 따로 설치하는 명령
원문은 격리된 칸을 BrowserContext라고 부릅니다(“One isolated BrowserContext per task, with its own cookies and storage” — 작업마다 격리된 BrowserContext 하나, 자기 쿠키와 저장소를 가짐). 브라우저 하나 안에서 쿠키와 저장소를 나누어 쓰는 단위를 가리키는 말입니다.
Space 기능은 ego(lite)와 함께 제공됩니다. 다만 스킬(에이전트에게 주는 사용 설명서 묶음)을 쓸 수 있는 에이전트를 이미 쓰고 있다면, ego-browser 스킬만 따로 설치할 수도 있습니다.
npx skills add github:CitroLabs/ego-lite/skills/ego-browser
ego-browser와 스킬이 무엇인지는 4장에서 설명합니다.
왜 이렇게 만들었나
에이전트에게 진짜 브라우저를 맡기려 할 때 흔히 쓰는 방법은 작업마다 브라우저를 하나씩 따로 띄우는 것입니다. 화면 없이 띄우거나(헤드리스), 내 프로필을 복사해서 씁니다. 여기에는 걸림돌이 하나 있습니다. Chrome이 사용자 정보를 담아 두는 폴더(user-data-dir — 로그인·북마크 등이 저장되는 곳)는 보통 한 번에 프로세스 하나만 쓸 수 있게 잠겨 있습니다. 그래서 내 실제 로그인을 여러 작업에서 함께 쓰려면, 그 잠금을 두고 다투거나 프로필을 임시 폴더로 통째로 복사해야 합니다.
Space는 다른 길을 택했습니다. 모든 에이전트 작업이 ego(lite)의 메인 프로세스를 함께 쓰고, 작업마다 쿠키·저장소용 칸(BrowserContext)만 따로 받습니다. 브라우저의 기반 시설과 내가 이미 갖춰 둔 로그인 환경은 그대로 다시 씁니다.
원문은 이 차이를 숫자로도 보여 줍니다. 빈 페이지(about:blank)만 여는 작업 6개를 동시에 시작한 실험입니다.
| 방식 | 늘어난 메모리 | 늘어난 프로세스 | 동시 시작에 걸린 시간 |
|---|---|---|---|
| 브라우저를 따로 띄우고 프로필 복사 | 약 15 GB | 약 84개 | 약 2.5초 |
| ego(lite) Space | 약 0.9 GB | 약 6개 | 약 0.6초 |
언제 Space를 쓰나, 언제 안 써도 되나
기준은 간단합니다. 진짜 브라우저, 진짜 로그인, 파일 주고받기 가운데 하나라도 필요하면 Space에서 할 일입니다.
🔐 로그인해야 보이는 곳
로그인된 대시보드, 개인 작업 공간, 주문 페이지, 비공개 문서.
🖱️ 손이 가는 일
누르기, 입력하기, 다음 쪽으로 넘기기, 조건으로 걸러 보기, 파일 올리기·내려받기가 필요한 일.
♻️ 이미 있는 로그인을 다시 쓰기
매번 새로 인증하지 않고, ego(lite)에 이미 들어 있는 로그인을 그대로 쓰고 싶을 때.
🔎 나중에 확인하고 싶은 일
에이전트가 어떤 페이지를 방문했고 무엇을 했는지 끝난 뒤에 살펴보고 싶은 작업.
| 맡기려는 일 | 알맞은 도구 | 이유 |
|---|---|---|
| 회사 주문 관리 화면에서 어제 주문을 걸러 파일로 받기 | Space | 로그인·걸러 보기·내려받기가 모두 필요합니다. |
| 내 계정의 알림 목록을 표로 정리하기 | Space | 로그인해야 보이는 화면입니다. |
| 누구나 볼 수 있는 자료를 찾아 요약하기 | 일반 웹 검색 | 로그인도, 누르고 입력하는 브라우저도 필요 없습니다. 원문 표현으로 “더 가볍습니다.” |
표의 세 가지 일은 이해를 돕기 위한 예시입니다. 판단 기준(로그인·조작·파일이 필요한가)은 원문 그대로입니다.
나와 에이전트가 함께 일하는 흐름
에이전트가 Space(에이전트 전용 작업 공간)에서 일하는 동안, 에이전트는 내가 보고 있는 페이지·마우스·화면 초점을 빼앗지 않습니다(화면 초점 — 지금 내 키보드 입력을 받고 있는 창이나 칸). 나는 하던 대로 인터넷을 쓰면 되고, 궁금하면 언제든 그 Space에 들어가 진행 상황을 볼 수 있습니다. 전형적인 흐름은 여섯 단계입니다.
① 내가 할 일을 설명합니다
Codex, Claude Code, Cursor 같은 에이전트의 대화창에 맡길 웹 작업을 글로 적습니다. 어떻게 적으면 좋은지는 3장 「일 맡기는 글 쓰기」에 있습니다.
② 에이전트가 Space에서 사이트를 엽니다
에이전트는 ego-browser(에이전트가 ego(lite)를 조종할 때 쓰는 명령 도구)로 브라우저를 움직이는 코드를 써서, 대상 사이트를 Space 안에서 엽니다. 내 탭에는 아무 일도 일어나지 않습니다.
③ 스냅샷을 읽고 그에 따라 움직입니다
에이전트는 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전)으로 화면을 파악한 뒤 누르고 입력합니다. 자세한 것은 3장.
④ 사람이 필요한 단계에서는 멈추고 나를 기다립니다
CAPTCHA(사람인지 확인하는 그림·퍼즐 검사), QR 코드 로그인, 결제 확인 같은 단계에서 에이전트는 멈추고 내가 들어와 처리하기를 기다립니다. 이것이 넘겨받기입니다 — 아래 소절.
⑤ 내가 끝내면 에이전트가 이어 갑니다
내가 그 단계를 처리하고 나면 에이전트가 남은 일을 계속합니다.
⑥ 끝나도 탭은 열려 있습니다
작업이 끝난 뒤에도 Space의 탭은 그대로 남아, 에이전트가 무엇을 보고 무엇을 했는지 내가 확인할 수 있습니다 — 끝난 뒤.
지켜보려면 — 오른쪽 위 Space 단추
에이전트가 무엇을 하는지 궁금하면 ego(lite) 오른쪽 위의 Space 단추를 누릅니다. Space 관리 패널(Space management panel — Space들을 모아 보여 주는 곳)이 열리고, 그 가운데 파란 빛이 도는 것이 에이전트가 지금 일하고 있는 Space입니다. 그 Space를 눌러 들어가면 에이전트가 하는 일을 볼 수 있고, 로그인이나 인증처럼 내가 필요한 일을 거기서 도울 수 있습니다.
제품 소개 문서는 여기에 한 가지를 더 적어 둡니다. 나는 어느 Space든 열어서 에이전트를 지켜보거나, 작업을 멈추게 하거나, 넘겨받을 수 있습니다.
에이전트가 Space를 조종하는 동안 달라지는 것 (변경 내역 기준)
- 에이전트가 Space를 조종하는 동안 그 Space의 주소창은 읽기 전용이고, 작업이 끝나거나 내가 넘겨받으면 바로 다시 입력할 수 있습니다(0.5.0.32에서 이 동작이 어긋나던 문제를 고침).
- 에이전트가 Space를 조종하는 동안에는 작업을 방해할 수 있는 브라우저·Space 단축키가 막히고, 자동 작업에 맞지 않는 브라우저 화면(페이지를 떠날지 묻는 창, 파일 선택 창, 자격 증명 입력 창, 외부 프로그램 연결)이 작업을 끊지 않습니다(0.4.6.12).
로그인 상태와 에이전트가 멈춰야 하는 순간
ego(lite)에 이미 로그인해 둔 사이트라면, 에이전트는 보통 로그인된 뒤의 화면에 바로 도착합니다. 쿠키(로그인 상태를 기억하는 정보)를 다시 가져오는 작업이 필요 없습니다. 그래서 “먼저 로그인부터 해 주세요”로 시작하지 않고 곧바로 본론으로 들어갈 수 있습니다.
반대로, 로그인되어 있다는 것은 에이전트가 내 이름으로 실제 일을 저지를 수 있다는 뜻이기도 합니다. 원문은 에이전트가 멈추고 나에게 조종을 돌려줘야 하는 상황을 네 가지로 듭니다.
| 상황 | 원문이 든 예 | 왜 사람이 해야 하나 |
|---|---|---|
| ① 본인 확인 | 문자·이메일 인증 코드, QR 코드 로그인, 하드웨어 보안 키(컴퓨터에 꽂거나 대는 인증용 열쇠) | 내 휴대폰·메일·열쇠가 있어야 합니다. |
| ② 돈이 오가는 일 | 결제, 주문, 송금, 환불 | 잘못되면 돈이 나갑니다. |
| ③ 되돌리기 어려운 변경 | 게시, 삭제, 보관, 그리고 쉽게 되돌릴 수 없는 일괄 수정 | 한 번 실행하면 원래대로 돌리기 어렵습니다. |
| ④ 계정 접근 허가 | 다른 회사 앱이 내 계정에 접근하도록 허가하는 화면 | 내 계정의 문을 열어 주는 결정입니다. |
「왜 사람이 해야 하나」 칸은 이해를 돕기 위해 이 가이드가 덧붙인 풀이입니다.
미리 경계를 정해 두기
에이전트가 알아서 멈추기를 기다리기만 할 필요는 없습니다. 일을 맡길 때 어디까지 해도 되는지를 먼저 적어 둘 수 있습니다. 원문이 든 문구는 두 가지입니다.
| 원문 문구 | 뜻 | 이럴 때 |
|---|---|---|
read-only, don't modify | 읽기만 하고, 아무것도 고치지 마세요. | 목록을 뽑거나 내용을 조사하는 일 |
stop and confirm before submitting | 제출하기 전에 멈추고 확인을 받으세요. | 양식을 채우게 하되 마지막 단추는 내가 누르고 싶을 때 |
어떤 작업을 해도 되는지를 ego(lite)가 대신 정해 주지는 않습니다. 경계는 나와 에이전트가 정합니다. 맡기는 글에 경계를 넣는 법은 3장, 실습은 활용편 실습 4(하지 말 것 정해 주기)와 실습 6(제출 직전에 멈추기)에 있습니다.
여러 작업을 동시에
Space는 여러 개를 동시에 돌릴 수 있고, 보통 작업 하나에 Space 하나를 씁니다. 몇 개까지 돌릴 수 있는지는 내 컴퓨터의 메모리와 CPU(컴퓨터의 계산 장치)에 달려 있습니다. 작업마다 탭·쿠키·저장소가 따로여서, 여러 작업을 함께 돌려도 서로 섞이지 않습니다.
| 알아 둘 것 | 내용 |
|---|---|
| 번호표는 작업끼리 통하지 않습니다 | 스냅샷에서 단추·입력 칸에 붙는 번호표(@N)는 그 작업의 것입니다. 서로 다른 작업은 번호표를 함께 쓰지 않습니다. |
| 화면이 바뀌면 새로 읽습니다 | 페이지 이동, 양식 제출, 탭 전환, 화면 일부가 다시 그려지는 변화가 있은 뒤에는 에이전트가 스냅샷을 새로 찍어야 합니다 — 3장 「번호표의 수명」. |
| Space 하나에 여러 작업 | Space 문서에는 “Space 하나가 여러 작업을 한꺼번에 담을 수 있고, 작업마다 자기 탭·쿠키·저장소를 가진다”는 문장도 있습니다. 평소에는 “작업 하나에 Space 하나, 여러 Space를 동시에”라고 이해하면 충분합니다. |
여러 작업을 한꺼번에 맡기는 연습은 활용편 실습 7에 있습니다.
에이전트가 쓰는 코드 — useOrCreateTaskSpace(name)
에이전트는 스크립트 첫머리에서 useOrCreateTaskSpace(name)을 부릅니다. 그 이름의 Space가 있으면 다시 쓰고, 없으면 새로 만들며, 스크립트의 나머지는 그 Space 안에서 실행됩니다. 원문 예시입니다.
ego-browser nodejs <<'EOF'
const task = await useOrCreateTaskSpace('describe your task')
await openOrReuseTab('https://example.com', { wait: true, timeout: 20 })
cliLog(await snapshotText())
await click('button.primary', { label: 'click the submit button' })
EOF
| 줄 | 하는 일 |
|---|---|
useOrCreateTaskSpace('…') | 작업 이름으로 Space를 다시 쓰거나 새로 만듭니다. 이후 줄은 이 Space 안에서 실행됩니다. |
openOrReuseTab('…') | 그 Space에서 주소를 엽니다. |
cliLog(await snapshotText()) | 현재 페이지의 스냅샷을 글로 받아 출력합니다. |
click('…', { label: '…' }) | 지정한 요소를 누릅니다. |
이 코드는 내가 쓰는 것이 아니라 에이전트가 씁니다. 각 도구의 자세한 뜻은 4장 ego-browser에 있습니다.
끝난 뒤 — 탭은 남고, Space는 복원됩니다
작업이 끝나도 Space의 탭은 바로 닫히지 않습니다. 에이전트가 무엇을 했는지 내가 다시 살펴볼 수 있게 남겨 두는 것입니다. 에이전트가 “이 페이지를 보고 답했다”고 하면 그 탭을 직접 열어 맞는지 볼 수 있습니다(확인하는 요령은 3장).
다만 언제까지나 남아 있는 것은 아닙니다. 에이전트 작업 Space는 명령 없이 30분이 지나면 자동으로 닫힙니다(변경 내역 0.6.0.12). 오래 두고 볼 Space는 고정(Pin — 자동으로 닫히거나 한꺼번에 비울 때 지워지지 않게 표시해 두는 기능)해 둡니다. 예외 조건은 이 소절 끝의 상자에 있습니다.
그러면 ego(lite)를 껐다 켜면 어떻게 될까요? 변경 내역(0.6.2.5)에 따르면 어떻게 꺼졌는지에 따라 다릅니다. 여기서 “고정한 Space”는 내가 고정해 둔 Space를, Profile(프로필 — 북마크·로그인을 따로 담는 브라우저 사용자 묶음)의 “시작 설정”은 브라우저를 켤 때 무엇을 열지 정하는 설정을 말합니다. 0.6.2.5는 사용자에게 차례로 나누어 배포되는(Staged rollout) 버전이어서, 내 ego(lite)가 아직 그 버전이 아니면 아래와 다르게 움직일 수 있습니다.
Space 복원은 각 Profile의 시작 설정을 따릅니다.
| 시작 설정 · 끄는 방법 | 다시 켰을 때 남는 Space |
|---|---|
| Open the New Tab page(새 탭 페이지 열기) | 고정한 Space |
| Open a specific page or set of pages(특정 페이지 또는 페이지 묶음 열기) | 고정한 Space |
| Continue where you left off(중단한 곳에서 계속하기) | 고정한 Space + 그때 쓰던 현재 Space |
| Spaces Overview(Space 전체 보기 화면)에서 종료 | 모든 Space |
앱 업데이트 등으로 재시작할 때는 모든 Space와 현재 세션(열어 둔 창·탭의 상태)이 그대로 유지됩니다. 시작 페이지가 덤으로 하나 더 열리지도 않습니다.
예기치 않게 꺼진 뒤에는 Restore pages(페이지 복원)를 고르느냐에 따라 달라집니다.
| 내 선택 | 결과 |
|---|---|
| Restore pages(페이지 복원)를 고름 | 다른 Profile의 Space까지 함께 복원됩니다. 고정한 Space가 먼저 복원되고, 그 뒤 또 비정상 종료 복구를 거쳐도 고정 상태가 유지됩니다. |
| 복원하지 않음 | 그 Space들은 닫힌 채로 남습니다. |
버전별로 달라진 점 (변경 내역에서 Space 보존·복원 관련만)
| 버전 (날짜) | 바뀐 것 |
|---|---|
| 0.4.6.12 (2026-08-07) | 에이전트가 만든 Space가 작업이 끝나거나, 멈추거나, 실패한 뒤에 세션 복원 대상에 다시 포함됩니다. 그래서 남겨 둔 작업 Space가 재시작 뒤에 돌아옵니다. |
| 0.4.7.1 (2026-08-20) | 작업이 끝난 뒤와 세션을 복원한 뒤의 Space 보존·복원이 더 안정적이 되어, 에이전트가 만든 Space가 사라지거나 어긋나는 일이 줄었습니다. |
| 0.5.0.28 (2026-09-08) | Space 고정(Pin) 기능. 고정 상태·순서·세션 데이터가 브라우저 재시작 뒤에(연달아 재시작해도) 복원됩니다. Space를 한꺼번에 비울 때 고정한 것은 남고, 고정한 Space를 닫을 때는 먼저 확인을 묻습니다. |
| 0.5.0.32 (2026-09-12) | 지난 세션을 복원하지 않고 시작한 Profile에서 고정한 Space와 그 탭이 복원되지 않던 문제를 고쳤습니다. 복원할 Space가 있으면 세션 설정에 따라 복원합니다. |
| 0.6.0.12 (2026-10-15) | 재시작하면 고정하지 않은 것까지 저장된 모든 Space를 복원합니다. 에이전트 작업 Space는 명령 없이 30분이 지나면 자동으로 닫힙니다(고정한 Space·내가 만든 Space·이미 나에게 넘겨진 Space 제외). |
| 0.6.2.5 (2026-10-29, 단계적 배포) | 위 세 탭의 내용 — 정상 종료는 Profile 시작 설정을 따르고, 재시작은 모두 유지하며, 비정상 종료는 Restore pages를 고르면 다른 Profile의 Space까지 복원합니다. |
0.6.2.5는 “단계적 배포(Staged rollout)”로 표시된 버전이어서, 내 ego(lite)에 아직 적용되지 않았을 수 있습니다. 전체 변경 내역은 부록에 있습니다.
자주 묻는 질문
| 질문 | 답 |
|---|---|
| Space가 내가 보고 있는 페이지에 영향을 주나요? | 아니요. 에이전트는 Space 안에서 일합니다. 내 탭, 화면 초점, 마우스는 건드리지 않습니다. |
| 작업이 끝나면 탭이 닫히나요? | 아니요, 바로 닫히지 않습니다. 에이전트가 한 일을 내가 살펴볼 수 있도록 Space가 탭을 남겨 둡니다. 다만 에이전트 작업 Space는 명령 없이 30분이 지나면 자동으로 닫히므로, 오래 둘 것은 고정해 둡니다 — 위 소절. |
| Space가 필요 없는 때는 언제인가요? | 공개된 자료를 찾거나 공개 페이지 하나를 요약하는 정도여서 로그인도, 누르고 입력하는 브라우저도 필요 없을 때입니다. 그럴 때는 일반 웹 검색이 더 간단한 도구입니다. |
- Space는 ego(lite)가 에이전트를 위해 따로 마련한 병렬 작업 공간입니다. 새 창·새 프로필·헤드리스·클라우드 세션이 아니고, 내 컴퓨터의 같은 ego(lite) 안에서 돕니다.
- 작업마다 브라우저를 따로 띄우는 대신 메인 프로세스를 함께 쓰므로, 잠금 다툼이나 프로필 복사 없이 가볍게 여러 작업을 돌립니다(6개 동시 실험 숫자는 구조를 보이려는 것).
- 진짜 브라우저·진짜 로그인·파일 주고받기가 필요하면 Space, 공개 정보만 찾으면 일반 웹 검색이 더 가볍습니다.
- 흐름은 “맡기기 → Space에서 열기 → 스냅샷 읽고 동작 → 멈추고 나를 기다림 → 이어서 진행 → 탭은 열린 채 확인”. 오른쪽 위 Space 단추로 언제든 들여다봅니다.
- 본인 확인, 돈이 오가는 일, 되돌리기 어려운 변경, 계정 접근 허가 앞에서는 에이전트가 멈춰야 합니다. 경계는 미리 글로 정해 둘 수 있고, 비밀번호·인증 코드는 대화창에 붙여 넣지 않습니다.
- 작업이 끝나도 탭은 바로 닫히지 않고 남습니다. 다만 에이전트 작업 Space는 명령 없이 30분이 지나면 자동으로 닫히므로, 오래 둘 것은 고정합니다. ego(lite)를 껐다 켰을 때 Space가 얼마나 돌아오는지는 꺼진 방식과 시작 설정에 따라 다릅니다.
출처: lite.ego.app/document/en/docs/space · lite.ego.app/document/en/docs/quick-start (Watch and take over) · lite.ego.app/document/en/docs/product-introduce (Space) · lite.ego.app/changelog (0.4.6.12 · 0.4.7.1 · 0.5.0.28 · 0.5.0.32 · 0.6.0.12 · 0.6.2.5) · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
스냅샷 — 에이전트가 페이지를 읽는 법
사람은 웹 페이지를 눈으로 봅니다. AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex 등)는 눈이 없으니 페이지를 글로 옮긴 요약본을 읽습니다. 그 요약본이 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전)입니다. 이 장에서는 스냅샷이 어떻게 생겼고 왜 필요한지, 그리고 그것을 알면 일을 더 잘 맡기고 결과를 더 잘 확인할 수 있는 이유를 설명합니다.
- 스냅샷이 무엇이고, 실제로 어떤 글이 나오는지
- 원본 페이지를 그대로 읽히는 것보다 무엇이 나은지
- 번호표(@N)가 왜 “그 순간에만” 쓸 수 있는 번호인지
- 내가 스냅샷이라는 말을 마주치게 되는 두 경우
- 일을 맡기는 글에 넣을 다섯 가지와, 결과를 확인하는 다섯 가지 신호
- 스냅샷이 다 읽지 못하는 것
- 스냅샷이란 무엇인가 — 로그인 페이지가 글로 바뀐 모습.
- 일을 맡기는 글 쓰기 — 다섯 가지 요소와 원문 예시 두 개.
- 결과 확인하기 — 끝난 뒤 살펴볼 다섯 가지 신호.
스냅샷이란 무엇인가
스냅샷(Snapshot)은 AI 에이전트가 웹 페이지를 읽는 방식입니다. ego(lite)는 지금 열려 있는 페이지를 짧고 정돈된 글로 바꾸고, 그 안에서 누르거나 채울 수 있는 요소(단추, 입력 칸, 링크)마다 @1, @2 같은 임시 번호를 붙입니다. 이 가이드에서는 그 번호를 번호표(@N)라고 부릅니다. 에이전트는 페이지의 원본 코드(HTML)를 통째로 읽거나 화면의 어느 위치를 눌러야 할지 짐작하는 대신, 이 스냅샷을 보고 다음에 할 일을 정합니다.
제품 소개 문서에 실린 예시입니다. 로그인 페이지 하나가 아래처럼 바뀝니다.
| 스냅샷의 줄 | 뜻 |
|---|---|
Page: · URL: | 페이지 제목과 지금 주소. 에이전트가 “내가 어디에 있는지” 아는 줄입니다. |
@1 [heading] "Log in" | 번호표 1번, 종류는 제목(heading), 적힌 글은 “Log in”. |
@3 [input type="email"] | 번호표 3번, 이메일을 적는 입력 칸. 칸 안의 안내 글은 “Email”. |
@5 [button type="submit"] "Continue" | 번호표 5번, 양식을 제출하는 단추. 적힌 글은 “Continue”. |
에이전트는 이 번호표에 대고 바로 동작합니다. 3번 칸을 채우려면 fill('@3', '...'), 5번 단추를 누르려면 click('@5')라고 씁니다. 페이지 코드 속 주소(CSS 선택자 — 코드에서 특정 요소를 가리키는 표기)를 짐작해서 맞힐 필요가 없으므로, 사이트가 코드 속 이름을 바꿔도 작업이 깨지지 않습니다. 이 스냅샷은 보통 수백 토큰(토큰 — AI가 읽고 쓰는 글의 양을 세는 단위. 많을수록 느리고 비용이 듭니다)이면 됩니다(소개 문서 기준 보통 200~400 토큰).
무엇을 해결하나
사람에게 웹 페이지는 눈으로 보는 화면입니다. 에이전트에게는 수만 토큰짜리 HTML·스크립트·스타일·실시간 상태 덩어리(스크립트 — 페이지를 움직이게 하는 코드, 스타일 — 색·크기 같은 꾸밈 정보)입니다. 이것을 AI 모델에 그대로 넣으면 두 가지 비용이 되풀이됩니다.
💸 토큰이 많이 듭니다
흔한 관리 화면 하나가 3만 토큰까지 나갈 수 있고, 동작 하나를 하기 전마다 그것을 다시 읽어야 합니다.
🌫️ 잡음에 파묻힙니다
페이지 전체 구조(DOM)의 대부분 — 스타일, 스크립트, 숨겨진 요소 — 은 “무엇을 누를까”라는 결정과 상관이 없고 방해만 됩니다.
스냅샷은 브라우저의 접근성 트리(화면 낭독기를 위해 브라우저가 따로 유지하는, 페이지의 의미 중심 구조)를 바탕으로 만들며, 페이지를 수백 토큰으로 줄입니다.
줄이고 난 뒤 스냅샷에 남는 것은 네 가지입니다.
| 남는 것 | 예 |
|---|---|
| 페이지 제목과 현재 주소 | Page: Example - Log in · URL: … |
| 보이는 글과 주요 구조 | 제목, 본문 글, 어떤 것이 어떤 것 안에 들어 있는지 |
| 누르고·채우고·고를 수 있는 요소, 그 종류와 이름 | [button] "Submit" · [input] "Search" |
| 그런 요소마다 붙는 임시 번호표 | @1, @2, @3 … |
이것만 있으면 에이전트는 어떤 단추를 누르고 어떤 칸을 채울지 정할 수 있습니다. 원본 HTML도, 화면 좌표도 필요 없습니다.
페이지 안쪽 깊은 곳까지 — 다만 전부는 아닙니다
ego(lite)는 스냅샷을 페이지에 스크립트를 끼워 넣어서 만들지 않고, 직접 고친 Chromium(Chrome의 바탕이 되는 브라우저 엔진) 엔진 안에서 만듭니다. 그래서 스냅샷이 더 빨리 돌아오고, 번호표로 하는 동작이 더 안정적이며, 스크립트 방식 도구가 흔히 놓치는 곳까지 닿는다고 원문은 설명합니다.
| 원문이 “읽는다”고 한 곳 | 쉬운 풀이 |
|---|---|
| 겹겹이 들어간 교차 출처 iframe | 다른 사이트의 페이지를 내 페이지 안에 끼워 넣은 것(교차 출처 — 주소가 다른 사이트에서 온 것) |
| shadow DOM | 바깥에서 잘 들여다보이지 않게 감싸 만든 화면 부품 |
| 다른 회사가 만든 끼워 넣기 부품 | Stripe 결제 창, Salesforce 끼워 넣기 화면, Intercom 패널, React portal(화면의 다른 자리에 띄우는 부품) |
번호표(@N)의 수명
스냅샷 속의 누를 수 있는 요소는 저마다 임시 번호를 받습니다.
@1 [input] "Search"
@2 [button] "Submit"
@3 [link] "Next page"
에이전트는 이 번호로 동작합니다. 예를 들어 2번 단추를 누를 때 await click('@2')라고 씁니다. 여기서 꼭 알아 둘 것은 번호표는 지금 찍은 스냅샷에서만 유효하다는 점입니다. 은행 창구의 대기 번호표가 그날 그 창구에서만 쓸모 있는 것과 같습니다.
페이지가 바뀌면 옛 번호는 더 이상 아무것도 가리키지 않을 수 있습니다. 원문이 꼽는 “바뀌는 순간”은 여섯 가지입니다.
| 바뀌는 순간 | 쉬운 풀이 |
|---|---|
| 이동 (navigation) | 다른 페이지로 넘어감 |
| 새로 고침 (refresh) | 같은 페이지를 다시 불러옴 |
| 대화 상자 (dialog) | 화면 위에 확인 창 같은 것이 뜸 |
| 양식 제출 (form submit) | 입력한 내용을 보냄 |
| 탭 전환 (tab switch) | 다른 탭으로 옮겨 감 |
| 동적 재렌더 (dynamic re-render) | 주소는 그대로인데 화면 일부가 스스로 다시 그려짐 |
그래서 원문이 권하는 믿을 만한 습관은 “번호를 붙들고 있지 말고, 변화가 있을 때마다 스냅샷을 새로 찍는 것”입니다. 이것은 에이전트가 할 일이지만, 알아 두면 에이전트가 “번호가 유효하지 않다”고 말할 때 당황하지 않습니다(FAQ). 또 서로 다른 작업은 번호표를 함께 쓰지 않습니다 — 2장 「여러 작업을 동시에」.
여러 단계에 걸쳐 같은 요소를 가리켜야 할 때 — loc= 와 CSS 선택자
여러 단계에 걸쳐 같은 요소를 흔들림 없이 가리켜야 하면, 에이전트는 스냅샷 출력에 들어 있는 loc=... 선택자를 안정된 선택자로 쓰거나, CSS 선택자를 직접 쓸 수 있습니다. 번호표(@N)는 지금 찍은 스냅샷에서만 유효하지만 이 선택자는 여러 단계에 걸쳐 붙들고 쓸 수 있다는 차이가 있습니다. 자세한 것은 4장 ego-browser에서 다룹니다.
내가 스냅샷을 보게 되는 두 경우
대부분의 경우 내가 스냅샷을 직접 만질 일은 없습니다. 에이전트가 알아서 읽습니다. 다만 다음 두 군데에서 스냅샷이 겉으로 드러날 수 있습니다.
① 에이전트가 “re-snapshot”, “page snapshot”이라고 말할 때
페이지에 변화가 생긴 것을 알아채고 지금 상태를 다시 읽는 중이라는 뜻입니다. 문제가 생긴 것이 아니라 정상적인 과정입니다.
② 작업 결과에 스냅샷 일부가 붙어 올 때
에이전트가 “이 화면을 보고 이렇게 답했다”는 근거로 스냅샷 발췌를 결과에 넣는 경우입니다.
에이전트 조건을 적용했더니 목록이 바뀌었습니다. re-snapshot 후 이어 가겠습니다. ← ① 다시 읽는 중
에이전트 완료했습니다. 근거로 삼은 page snapshot 일부입니다. ← ② 근거로 붙은 발췌
@3 [link] "Next page"
실제 문구와 모양은 쓰는 에이전트에 따라 다릅니다. 두 낱말(re-snapshot, page snapshot)만 원문에 나온 표현입니다.
일을 맡기는 글 쓰기 — 다섯 가지 요소
스냅샷(에이전트가 읽는 페이지의 글 버전)은 에이전트가 페이지를 또렷이 보도록 돕습니다. 하지만 어디까지 해도 되는지, 작업의 경계를 정하는 것은 나입니다. 원문은 좋은 작업 설명에 다음 다섯 가지가 들어 있다고 말합니다.
| 요소 | 적을 내용 | 원문이 든 예 |
|---|---|---|
| ① 대상 | 어느 페이지·사이트에서 할 일인가 | — |
| ② 할 일 | 무엇을 읽고, 채우고, 누르고, 내려받을 것인가 | — |
| ③ 하면 안 되는 것 | 절대 하지 말아야 할 동작 | 삭제, 게시, 결제, 메일 보내기 등 |
| ④ 멈출 곳 | 어떤 화면에서 멈추고 나를 기다릴 것인가 | CAPTCHA(사람인지 확인하는 검사), 결제, 권한 허가 화면 |
| ⑤ 결과의 모양 | 어떤 형태로 돌려받고 싶은가 | 표, 요약, 스크린샷, 내 컴퓨터의 파일 경로 |
원문에 실린 예시 두 개입니다. 원문 그대로 두고 아래에 뜻을 달았습니다.
Open my GitHub Notifications and list the PRs that need my review — repo name, title, URL.
Don't archive, don't mark anything as read.
뜻: 내 GitHub 알림(Notifications)을 열고, 내 검토가 필요한 PR(Pull Request — 코드 변경을 합쳐 달라는 요청)을 저장소 이름·제목·주소와 함께 나열해 주세요. 보관 처리하지 말고, 어떤 것도 읽음으로 표시하지 마세요.
| 요소 | 이 예시에서 |
|---|---|
| ① 대상 | 내 GitHub 알림 화면 |
| ② 할 일 | 내 검토가 필요한 PR 나열하기 (읽기만) |
| ③ 하면 안 되는 것 | 보관 처리, 읽음 표시 |
| ⑤ 결과의 모양 | 저장소 이름 · 제목 · 주소 |
따라 해 보기: 활용편 실습 4 — 로그인된 사이트에서 목록 뽑기
Open the orders dashboard, filter yesterday's orders, and download the CSV.
Pause if you hit a login challenge or an export confirmation, and tell me where the file landed.
뜻: 주문 관리 화면을 열고, 어제 주문만 걸러서 CSV(표 형태의 자료 파일)를 내려받아 주세요. 로그인 확인 요구나 내보내기 확인 창이 나오면 멈추고, 파일이 어디에 저장됐는지 알려 주세요.
| 요소 | 이 예시에서 |
|---|---|
| ① 대상 | 주문 관리 화면 |
| ② 할 일 | 어제 주문 걸러 보기, CSV 내려받기 |
| ④ 멈출 곳 | 로그인 확인 요구, 내보내기 확인 창 |
| ⑤ 결과의 모양 | 파일이 저장된 위치 |
따라 해 보기: 활용편 실습 5 — 파일 내려받기
결과 확인하기 — 다섯 가지 신호
작업이 끝났다고 하면, 에이전트의 보고를 그대로 믿기 전에 다음 다섯 가지를 살펴봅니다. 원문이 “확인할 신호”로 꼽은 것입니다.
| 확인할 신호 | 이렇게 봅니다 |
|---|---|
| ① 방문한 페이지와 핵심 동작 | 에이전트가 어떤 페이지를 방문했고 어떤 핵심 동작을 했는지 밝혔나요? |
| ② 대조할 수 있는 값 | 돌려받은 결과에 내가 직접 맞춰 볼 수 있는 것(제목, ID(고유 번호), 주소, 금액, 시각)이 들어 있나요? |
| ③ 파일 위치 | 내려받기 작업이라면 내 컴퓨터의 어느 경로에 저장됐는지 알려 줬나요? |
| ④ 마지막 단계 전 멈춤 | 무언가를 고치거나 제출하는 일이라면, 마지막 단계 전에 멈추고 확인을 받았나요? |
| ⑤ 열려 있는 페이지 | 관련 페이지가 Space에 아직 열려 있어 내가 직접 볼 수 있나요? (작업이 끝나도 Space의 탭은 남습니다 — 2장) |
스냅샷이 못 읽는 것, 그리고 자주 묻는 질문
스냅샷이 언제나 모든 것을 읽는 것은 아닙니다. 원문은 다음 네 가지가 온전히 나타나지 않을 수 있다고 밝힙니다.
앞에서 본 것처럼 ego(lite)의 스냅샷은 교차 출처 iframe과 shadow DOM 안쪽까지 닿는 것을 장점으로 내세웁니다(무엇을 해결하나). 그렇더라도 위 네 가지에서는 빈 곳이 생길 수 있으니, 에이전트가 “이 부분은 읽지 못했다”거나 “스크린샷으로 확인했다”고 말하면 그럴 수 있는 일로 받아들이고 필요하면 내가 직접 확인합니다.
| 질문 | 답 |
|---|---|
| 에이전트가 왜 “번호(ref)가 유효하지 않다”고 하나요? | 앞서 찍은 스냅샷 이후에 페이지가 바뀌었기 때문입니다. 스냅샷을 새로 찍으라고 하면 됩니다. → 번호표의 수명 |
| 스냅샷은 모든 것을 읽나요? | 항상 그렇지는 않습니다. 화면 밖 내용, 이미지 속 글, 복잡한 canvas, 샌드박스된 교차 출처 iframe은 온전히 나타나지 않을 수 있습니다. 그럴 때 에이전트는 스냅샷에 스크린샷, 글 추출, 사람의 확인을 섞어 쓸 수 있습니다. |
| 스냅샷을 찍으면 페이지의 무언가가 바뀌나요? | 아니요. 스냅샷은 페이지 구조를 읽기만 합니다. 실제로 상태를 바꾸는 것은 그 뒤에 일어나는 누르기, 채우기, 제출, 올리기, 삭제입니다. |
| @1, @2 같은 번호를 내가 외워야 하나요? | 아니요. 지금 페이지에만 쓰는 임시 번호로 여기면 됩니다. 번호는 에이전트가 쓰고, 나는 목표와 경계를 정합니다. |
번호표 오류나 이상한 결과를 만났을 때 따라 할 순서는 활용편 실습 10에 정리되어 있습니다.
- 스냅샷은 에이전트가 페이지를 읽는 방식입니다. 페이지를 짧은 글로 바꾸고, 누르거나 채울 수 있는 요소마다 번호표(@N)를 붙입니다.
- 원본 페이지는 3만 토큰까지 나갈 수 있지만, 접근성 트리를 바탕으로 만든 스냅샷은 수백 토큰입니다(소개 문서 기준 보통 200~400).
- 번호표는 지금 찍은 스냅샷에서만 유효합니다. 페이지가 바뀌면 에이전트는 스냅샷을 새로 찍습니다.
- 맡기는 글에는 대상 · 할 일 · 하면 안 되는 것 · 멈출 곳 · 결과의 모양을 적습니다. 경계를 정하는 것은 나입니다.
- 끝난 뒤에는 방문한 페이지와 동작, 대조할 수 있는 값, 파일 위치, 제출 전 멈춤, Space에 열린 페이지를 확인합니다. 이상하면 스냅샷을 다시 찍게 합니다.
- 스냅샷은 iframe·shadow DOM 안쪽까지 닿지만 전부는 아닙니다. 화면 밖 내용, 이미지 속 글, 복잡한 canvas, 샌드박스된 교차 출처 iframe은 다 보이지 않을 수 있고, 스냅샷은 페이지를 읽기만 할 뿐 바꾸지 않습니다.
출처: lite.ego.app/document/en/docs/snapshot · lite.ego.app/document/en/docs/product-introduce (Snapshot) · lite.ego.app (첫 화면 — Reaches iframes, shadow DOM, and embedded widgets) · lite.ego.app/document/en/docs/space (Many tasks at once — 번호표 공유) · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
ego-browser와 스킬 — 브라우저를 조종하는 도구
2장에서는 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)가 어디서 일하는지(Space), 3장에서는 페이지를 어떻게 읽는지(스냅샷)를 보았습니다. 이 장은 그 둘을 실제로 움직이는 손, ego-browser를 다룹니다. 에이전트가 짧은 스크립트(할 일을 순서대로 적은 코드) 한 덩어리를 쓰면 ego-browser가 “열기 → 읽기 → 누르기 → 결과 보고”를 한 번에 실행합니다. 이 도구를 직접 쓸 일은 거의 없지만, 원리를 알면 에이전트가 왜 빠른지, 어디서 막히는지 이해하기 쉽습니다.
- ego-browser가 무엇이고 누구를 위한 도구인지, Playwright·Puppeteer와 무엇이 다른지
- 스킬이 무엇이고, ego-browser 스킬이 다른 방식과 다른 점 다섯 가지
- 에이전트가 페이지를 다루는 기본 흐름 5단계와, 그것을 코드 한 덩어리로 보내는 이유
- 도우미 함수의 종류, 번호표(@N)가 통하는 범위, 곧 나올 “경험 쌓기”
- 안전하게 쓰기 위해 알아 둘 것과 스크립트를 쓸 때의 주의 사항
- ego-browser란 — 사람이 아니라 에이전트가 읽고 쓰는 조종 도구라는 점.
- 스킬이란 — 에이전트에게 주는 사용 설명서. 다른 방식과 다른 점 다섯 가지.
- 기본 흐름 5단계 — Space 준비부터 결과 출력까지 한 번에 실행되는 모습.
ego-browser란 — 에이전트가 쓰는 조종 도구
ego-browser는 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex, Cursor 등)가 ego(lite)를 조종할 때 쓰는 명령줄 도구(화면 단추 대신 글자 명령으로 부르는 프로그램)입니다. ego(lite)가 에이전트용으로 함께 내놓는 브라우저 자동화 실행 도구이며, ego(lite) 안에서 실제로 돌아가는 Chromium(Chrome의 바탕이 되는 브라우저 엔진) 브라우저를 움직입니다. 원문의 설명을 셋으로 나누면 이렇습니다.
| 특징 | 뜻 |
|---|---|
| 스크립트를 통째로 받는다 | 에이전트는 할 일 전체를 JavaScript(웹에서 널리 쓰는 프로그래밍 언어) 코드로 써서 한 번에 넘깁니다. ego-browser가 받는 형식은 Node.js(JavaScript 코드를 브라우저 밖에서 실행해 주는 프로그램) heredoc(히어독 — 여러 줄 스크립트를 한 번에 넘기는 방식) 스크립트입니다. |
| 도우미가 미리 준비되어 있다 | “페이지 열기”, “스냅샷 읽기”, “누르기” 같은 도우미 함수(함수 — 이름을 적어 부르면 정해진 일을 해 주는 코드 묶음)가 스크립트 안에 미리 들어 있어, 따로 불러오지 않고 이름만 쓰면 됩니다. |
| 상태는 Space에 남는다 | 열어 둔 탭 같은 브라우저 상태는 Space(스페이스 — 에이전트 전용 작업 공간) 안에 그대로 남습니다. Space는 2장에서 설명했습니다. |
누구에게 필요한가
브라우저를 다뤄야 하는 코딩 에이전트
Claude Code, Codex, Cursor, 직접 만든 SDK(개발 도구 묶음) 에이전트.
특정 업무용 에이전트를 만드는 팀
Lark, Google Docs, Salesforce 같은 업무 관리 화면을 자동화하려는 팀.
정해진 웹 작업을 되풀이하는 경우
로그인, 입력, 내보내기, 검색, 표 읽기.
토큰 한계에 부딪혀 본 사람
페이지 원본 코드(DOM·HTML)를 통째로 AI에 넣으려다 토큰(AI가 읽고 쓰는 글의 양을 세는 단위 — 비용·속도의 기준) 한계에 막혀 본 사람.
Playwright·Puppeteer와 무엇이 다른가
| Playwright · Puppeteer | ego(lite) + ego-browser | |
|---|---|---|
| 정체 | 내 코드 안에 넣어 쓰는 브라우저 자동화 라이브러리(프로그램 부품) | 진짜 브라우저 + 에이전트와 브라우저를 잇는 연결 층 |
| 요소를 가리키는 법 | CSS 선택자(페이지 코드에서 요소를 가리키는 주소 표기). 사이트가 구조를 바꾸면 깨집니다. | 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전)의 번호표(@N). 페이지 코드 속 이름(class 이름)이 바뀌어도 그대로 통합니다. |
| 일하는 방식 | 도구를 하나 부르고 결과를 받는 왕복을 되풀이 | snapshot, fill, click, wait, navigate, capture 도구를 엮은 JavaScript 조각을 한 번에 실행 |
| 읽는 양 | — | 스냅샷은 HTML보다 토큰이 적게 듭니다. |
| 준비물 | — | 연결할 SDK도, Playwright·Puppeteer 쪽에서 설치할 것도 없습니다. |
출처는 ego(lite) 첫 화면의 FAQ입니다. “—”는 원문이 따로 말하지 않은 칸입니다.
설치
따로 설치할 것이 없습니다. ego(lite)를 설치하면 함께 들어옵니다(1장 설치). 설치 뒤에는 어느 폴더에서나 ego-browser를 실행할 수 있습니다. 에이전트마다 연결하는 방법은 5장에 있습니다.
스킬만 따로 설치하기
스킬만 따로 설치할 수도 있습니다. 다만 스킬은 ego(lite) 브라우저에 묶여 있으므로 ego(lite)가 먼저 설치되어 있어야 합니다.
npx skills add github:CitroLabs/ego-lite/skills/ego-browser
스킬이란 — 에이전트에게 주는 사용 설명서
스킬(Skill — 에이전트에게 “이 도구는 이렇게 써라” 하고 알려 주는 사용 설명서 묶음)은 ego-browser를 에이전트가 바로 쓸 수 있는 작업 방식으로 포장한 것입니다. ego-browser 스킬이 있으면 Claude Code, Codex 같은 여러 에이전트가 내 ego(lite) 브라우저를 쓸 수 있습니다. 에이전트는 내가 로그인해 둔 상태를 그대로 써서 웹 작업을 하고, 나는 Space 덕분에 지켜보거나, 넘겨받거나, 방해받지 않고 내 페이지를 계속 볼 수 있습니다.
원문(Skills 문서)은 다른 방식과 다른 점을 다섯 가지로 듭니다. 첫 번째부터 그림으로 봅니다.
| 다른 점 | 내용 |
|---|---|
| ① 내 에이전트를 쓴다 | Codex, Claude Code, OpenClaw, Hermes Agent 등 어떤 에이전트든 ego(lite)를 통해 내 로그인으로 웹 페이지를 다룰 수 있습니다. |
| ② 에이전트 전용 작업 공간 | ego(lite)는 에이전트용으로 분리된 Space를 따로 마련합니다. 나는 앞에서 인터넷을 쓰고 에이전트는 뒤에서 일하며, 서로 다투지 않습니다. 어느 Space에서 작업이 도는지 언제든 볼 수 있고, 넘겨받거나 멈출 수 있습니다. agent-browser 같은 Chrome 연결 방식에서 창과 탭이 마구 생겨나던 문제를 뿌리부터 없앱니다. |
| ③ 명령이 아니라 코드 | ego(lite)는 스냅샷, 누르기, 페이지 안 JavaScript 실행, CDP 직접 호출 같은 능력을 명령줄 명령이 아니라 JavaScript 함수로 내줍니다. 그래서 여러 단계를 한 번에 묶을 수 있습니다. → 왜 코드 한 덩어리인가 |
| ④ 품질 좋은 페이지 스냅샷 | 깊이 손본 Chromium이 스냅샷을 안정적으로 만들어 냅니다. 스냅샷은 글을 읽는 AI 모델이 페이지를 “보고” “다루는” 창입니다. 깊게 겹친 iframe(페이지 안에 끼워 넣은 다른 페이지)처럼 다른 방식이 걸려 넘어지는 경우도 처리합니다. → 3장 |
| ⑤ 쓸수록 빨라진다 곧 제공 예정 | 성공한 조작과 시도한 경로를 다시 쓸 수 있는 도구·작업 순서로 정리해 두는 장치가 스킬에 들어 있습니다. 지금은 제한 베타입니다. → 경험 쌓기 |
어디에 쓰나 — 평소 브라우저에서 하는 일이면 무엇이든 대상입니다. 원문이 든 예는 CRM(고객 관리 도구), 받은편지함, ATS(채용 지원자 관리 도구), 회계 도구, SNS 계정, 예약 사이트, 사내 관리 화면입니다. 다만 진짜 브라우저 조종 권한을 주는 것이므로 안전 주의를 꼭 읽어 두세요.
기본 흐름 5단계 — 한 번의 호출로 끝까지
에이전트가 페이지를 다루는 순서는 거의 늘 같습니다. Space 준비 → 페이지 열기 → 스냅샷 읽기 → 동작하기 → 결과 출력. 중요한 점은 이 다섯 단계를 하나씩 따로 보내지 않고 스크립트 하나에 모두 적어 한 번에 넘긴다는 것입니다.
원문(제품 소개)의 예시를 한 줄씩 따라가 봅니다. x.com의 ego_agent 페이지에서 Follow(팔로우) 단추를 누르는 스크립트입니다.
ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('follow-ego-agent')
await openOrReuseTab('https://x.com/ego_agent', { wait: true })
await snapshotText()
await click('@92') // @92 is the Follow button from the snapshot
cliLog('Done.')
EOF
① Space 준비
ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('follow-ego-agent')
첫 줄은 ego-browser를 부르면서 “여기서부터 EOF라고 적힌 줄까지가 스크립트다”라고 알리는 표시입니다. 이것이 heredoc입니다. 둘째 줄은 이 작업용 Space를 준비합니다. 이미 있으면 다시 쓰고, 없으면 새로 만듭니다. 따옴표 안은 작업 이름입니다. 줄 앞의 await는 “이 일이 끝나기를 기다렸다가 다음 줄로 간다”는 JavaScript 표기입니다.
② 페이지 열기
await openOrReuseTab('https://x.com/ego_agent', { wait: true })
그 Space 안에서 주소를 엽니다. 함수 이름대로 탭을 새로 열거나 열려 있는 탭을 다시 씁니다. wait: true는 기다림 옵션을 켠 것입니다.
③ 스냅샷 읽기
await snapshotText()
페이지를 글로 옮긴 스냅샷을 받습니다. 누를 수 있는 요소마다 번호표(@N)가 붙어 나옵니다. 스냅샷과 번호표는 3장에서 설명했습니다.
④ 동작하기
await click('@92') // @92 is the Follow button from the snapshot
번호표 @92를 누릅니다. // 뒤는 사람이 읽으라고 적은 설명입니다. “@92는 스냅샷에 나온 Follow(팔로우) 단추”라는 뜻입니다.
⑤ 결과 출력
cliLog('Done.')
EOF
cliLog는 결과를 에이전트에게 돌려주는 단 하나의 통로입니다. 여기에 넣은 것만 에이전트가 받아 봅니다. EOF는 스크립트의 끝입니다.
이 호출 한 번이 페이지를 열고, 읽고, 단추를 누르고, 결과를 보고합니다. ego-browser 문서의 기본 예시도 같은 순서입니다. 단추를 누르는 대신 읽어 온 스냅샷을 그대로 출력한다는 점만 다릅니다(아래 접힌 상자).
ego-browser 문서의 기본 예시 — 스냅샷을 읽어 그대로 출력하기
ego-browser nodejs <<'EOF'
const task = await useOrCreateTaskSpace('search github issues')
await openOrReuseTab('https://github.com/issues', { wait: true, timeout: 20 })
cliLog(await snapshotText())
EOF
| 줄 | 하는 일 |
|---|---|
| const task = await useOrCreateTaskSpace('search github issues') | “search github issues(GitHub 이슈 찾기)”라는 이름의 작업용 Space를 다시 쓰거나 새로 만들고, task라는 이름으로 기억해 둡니다. |
| await openOrReuseTab('https://github.com/issues', { wait: true, timeout: 20 }) | GitHub 이슈 페이지를 엽니다. 기다림 옵션을 켜고, 기다리는 한도(timeout)를 20초로 두었습니다. |
| cliLog(await snapshotText()) | 스냅샷을 읽어서 그대로 출력합니다. 번호표·loc·url이 붙은 페이지 구조가 에이전트에게 돌아갑니다. |
다섯 단계의 원문 설명과 권장 작업 순서
원문은 snapshotText와 번호표·loc로 시작하라고 권합니다. 요소의 뜻이 그대로 살아 있고, 좌표로 누를 때처럼 쉽게 어긋나지 않기 때문입니다.
- 작업용 Space를 다시 쓰거나 만든다.
- 페이지를 열거나 그 페이지로 옮겨 간다(
openOrReuseTab/gotoAndWait). snapshotText()로[ref=N, loc=..., url=...]가 붙은 의미 구조 트리(요소의 역할과 이름을 나뭇가지처럼 정리한 목록)를 받는다. 번호표는 refMap(번호표 대장)에 자동으로 등록된다.click/fillInput/elementEval로 @N에 동작하거나,js(...)안에서 필요한 내용을 한 번에 뽑는다. 번호표 대신 CSS 선택자로 가리킬 수도 있다.cliLog(...)로 최종 결과를 출력한다.
함께 쓸 수 있는 다른 길도 있습니다.
captureScreenshot+click([x, y])— 화면 사진을 찍고 좌표로 누릅니다. 시각적 배치가 중요한 화면, canvas(그림판처럼 직접 그려 만든 화면)로 그린 화면, 가상 목록(보이는 부분만 그때그때 만드는 긴 목록), 접근성 정보가 불완전한 페이지에 씁니다.js/elementEval/cdp— 페이지 구조에서 직접 뽑아내거나, 브라우저 상태를 살피거나, 표준 도우미에 딱 맞지 않는 일에 씁니다.
이동, 관찰, 스크롤, 추출, 걸러 내기, 합치기, 출력을 하나의 ego-browser nodejs heredoc 안에 둡니다. 데이터를 내 컴퓨터의 두 번째 node 스크립트로 넘겨 다시 처리하지 않습니다.
heredoc 안은 Node.js 프로세스이고, js(...) 안은 페이지 안입니다. 둘을 섞지 않습니다.
왜 명령 하나씩이 아니라 코드 한 덩어리인가
많은 도구에서는 “열기”, “읽기”, “누르기”가 각각 따로 부르는 명령입니다. AI 모델은 한 명령의 결과를 읽은 뒤에야 다음 명령을 보낼 수 있습니다. ego-browser는 이 왕복을 한 번으로 줄입니다.
| 무엇 | 원문이 말하는 것 |
|---|---|
| 잘하는 일을 시킨다 | 에이전트가 가장 잘하는 일은 코드 쓰기입니다. “명령 두 개 실행 → 출력 보기 → 두 개 더 실행”을 되풀이하는 대신, 여러 단계의 조작을 한 번의 출력으로 묶습니다. |
| Node.js를 넣어 두었다 | 이것이 가능하도록 ego(lite) 안에 Node.js를 넣었습니다. 설치 용량은 10 MB만 늘어납니다. |
| 얼마나 빠른가 | Skills 문서의 내부 측정에서 같은 작업이 20~50% 빨리 끝났다고 합니다. 만든 곳이 자체로 잰 값입니다. |
| 무엇이 싸지나 | 싸지는 것은 한 단계가 아니라 작업 전체입니다. 한 번에 하나씩 도구를 부르고 결과를 기다리는 Playwright·Puppeteer와 대부분의 자동화 틀과 달리, JavaScript 몇 줄로 여러 동작을 페이지에서 실행합니다. 이런 기능 여러 개가 겹쳐서, 복잡한 작업이 더 빨리 끝나고 전체 토큰도 줄어듭니다. |
도우미 함수 — 종류별로 한눈에
도우미 함수는 ego-browser가 스크립트 안에 미리 넣어 둔 조작 단추들입니다. 모두 camelCase(낙타 표기 — openOrReuseTab처럼 낱말 첫 글자를 대문자로 이어 붙인 이름) 이름으로 바로 쓸 수 있고, 따로 불러오는 절차(import)가 필요 없습니다. 외울 필요는 없습니다. 에이전트가 스킬 설명서를 읽고 알아서 고릅니다. 아래 표로 “이런 종류가 있구나” 정도만 보세요.
| 분류 | 하는 일 | 대표 함수 |
|---|---|---|
| Task Space | 작업용 Space를 만들고, 다시 쓰고, 마치고, 닫기 | useOrCreateTaskSpace |
| 이동과 상태 | 탭을 열고 옮겨 다니며 지금 페이지 정보 보기 | openOrReuseTab · gotoAndWait |
| 관찰 | 스냅샷 읽기, 화면 사진 찍기 | snapshotText · captureScreenshot |
| 마우스·스크롤 | 누르기, 두 번 누르기, 올려 두기, 끌기, 화면 내리기 | click · scrollBy |
| 키보드·입력 | 글자 치기, 입력 칸 채우기, 키 누르기 | fillInput · pressKey |
| 파일·네트워크 | 파일 올리기, 페이지 쪽에서 자료 요청하기 | uploadFile · httpGet |
| 기다리기 | 정한 시간, 페이지 로딩, 요소가 나타날 때까지 기다리기 | wait · waitForElement |
| 페이지 안 실행 | 페이지 안에서 JavaScript를 실행해 내용 뽑기 | js · elementEval |
| 출력·도움말 | 결과 출력, 함수 사용법 찾아보기 | cliLog · help |
아래 접힌 상자에 원문의 전체 목록과 코드가 있습니다. 원문에 설명 없이 이름만 나온 함수는 이름의 뜻만 옮겼습니다.
Task Space — 작업용 Space 다루기
await listTaskSpaces()
const task = await useOrCreateTaskSpace('describe task') // reuse or create
await completeTaskSpace(task.name) // done, keep the tab
await closeTaskSpace(task.name) // shut the space down
listTaskSpaces()— 작업용 Space 목록.useOrCreateTaskSpace('…')— 다시 쓰거나 새로 만듭니다.completeTaskSpace(task.name)— 작업을 마쳤다고 표시하되 탭은 남겨 둡니다.closeTaskSpace(task.name)— Space를 닫습니다.
이름(name)은 작업을 설명하는 3~6 단어의 자연스러운 말로 짓습니다. 뜻 없는 자리 채움 말(placeholder)을 쓰지 않습니다.
이동과 상태 — 탭 열기·옮기기
await listTabs()
await openOrReuseTab(url, { wait: true, timeout: 20 })
await gotoAndWait(url, { timeout: 20, settle: 1 })
await newTab(url)
await switchTab(tabId)
await currentTab()
await pageInfo()
await ensureRealTab() // a fresh task space may have no tab yet
listTabs탭 목록 ·newTab새 탭 ·switchTab탭 바꾸기 ·currentTab지금 탭 ·pageInfo페이지 정보.openOrReuseTab— 주소를 열거나 이미 열린 탭을 다시 씁니다.gotoAndWait— 주소로 가서 기다립니다.ensureRealTab()— 갓 만든 작업용 Space에는 아직 탭이 없을 수 있어, 실제 탭이 있도록 해 둡니다.
관찰 — 스냅샷과 화면 사진
await snapshotText() // full-page semantic snapshot (default)
await snapshotText({ scope: 'only_within_viewport' })
await captureScreenshot('result.png')
await drainEvents() // consume the nav / network event queue
snapshotText()— 페이지 전체의 스냅샷(기본값).scope: 'only_within_viewport'를 주면 지금 화면에 보이는 영역(뷰포트)만 읽습니다.captureScreenshot('result.png')— 화면 사진을 찍습니다.drainEvents()— 쌓여 있는 페이지 이동·네트워크 이벤트 대기열을 비워 가져옵니다.
마우스와 스크롤 — 누를 곳을 가리키는 세 가지 방법
click, doubleClick, hover, dragMouse는 대상을 같은 형식으로 받습니다(단위는 CSS 픽셀).
| 형식 | 뜻 |
|---|---|
| 'string' | CSS 선택자 또는 번호표(@ref). 요소의 한가운데를 누릅니다. |
| [x, y] 또는 {x, y} | 화면(뷰포트) 좌표. |
| {selector, x, y} | 요소의 왼쪽 위 모서리에서 떨어진 거리. |
| options.label | 3~6 단어의 설명. 넣으면 그 동작이 화면에 강조 표시됩니다. |
await click('@21', { label: 'check the login state' })
await click('button.primary', { label: 'click the submit button' })
await click([420, 260])
await hover('@5', { label: 'hover to reveal the menu' })
await dragMouse([from, to], { label: 'drag the card' })
await scrollBy(900)
await scroll({ dy: 900 })
await scrollToBottomUntil(
async () => await js(String.raw`document.querySelectorAll('article').length`) >= 20,
{ step: 900, wait: 1, maxSteps: 20 },
)
마지막 scrollToBottomUntil 예시는 조건(여기서는 article 요소가 20개 이상)이 맞을 때까지 아래로 내립니다. 옵션 이름대로 읽으면 한 번에 900씩(step), 1초씩 기다리며(wait), 최대 20번(maxSteps)입니다.
키보드와 입력
await typeText('hello world')
await fillInput('@2', 'user@test.com')
await pressKey('Enter')
await dispatchKey({ ... })
typeText글자 치기 ·fillInput번호표 @2 입력 칸에 값 채우기 ·pressKey키 누르기 ·dispatchKey키 이벤트를 직접 보내기.
파일과 네트워크
await uploadFile('input[type="file"]', '/absolute/path/to/file.pdf')
await httpGet('https://api.example.com/data') // GET issued in the page's context
uploadFile— 파일 선택 칸에 파일을 올립니다. 예시의 경로는 절대 경로(맨 위 폴더부터 다 적은 경로)입니다.httpGet— 페이지 쪽에서 GET 요청(주소의 내용을 받아 오는 요청)을 보냅니다.
기다리기 — 시간 단위는 초
await wait(1) // seconds
await waitForLoad()
await waitForElement('@1')
await waitForNetworkIdle()
wait()와 timeout의 단위는 초입니다. 이름이 Ms로 끝나는 값만 밀리초(1000분의 1초)입니다. waitForLoad는 페이지 로딩, waitForElement는 요소, waitForNetworkIdle은 네트워크가 잠잠해지기를 기다립니다.
페이지 안에서 실행하기 — js()
js(source)는 내부적으로 CDP의 Runtime.evaluate이며 문자열을 받습니다. Puppeteer처럼 함수와 인자를 넘기지 마세요. 그러면 경고가 나오고 .toString()으로 감싸지며, 클로저 변수(함수 바깥에서 끌어다 쓰던 값)와 인자 전달 통로가 모두 사라집니다.
여러 단계의 처리는 IIFE(즉시 실행 함수 — 만들자마자 바로 실행되는 함수 꼴 (() => { … })())로 감싸 결과를 한 번만 돌려줍니다.
const data = await js(String.raw`(() => {
const items = [...document.querySelectorAll('article')]
return items.map(el => ({
text: el.innerText,
links: [...el.querySelectorAll('a')].map(a => a.href),
}))
})()`)
await elementEval('@1', el => el.getBoundingClientRect())
await cdp('Page.captureScreenshot', { format: 'png' })
- 위
js예시는 페이지의article요소마다 글과 링크 목록을 뽑습니다. elementEval('@1', …)— 번호표 @1 요소 하나에 대해 실행합니다(예시는 위치·크기 얻기).cdp('…', {…})— CDP 명령을 직접 보냅니다(예시는 PNG 화면 사진).
heredoc 안은 Node.js 프로세스이고 js(...) 안은 페이지 안입니다. 둘을 섞지 않습니다.
출력과 도움말
cliLog(value) // the only output channel in a heredoc
cliLog(help('click')) // look up a helper's usage
cliLog는 heredoc 안에서 유일한 출력 통로입니다. help('click')처럼 부르면 그 도우미의 사용법을 볼 수 있습니다.
번호표(@N)가 통하는 범위
번호표(@N)는 영구적인 이름표가 아닙니다. 가장 최근에 읽은 스냅샷에 나온 번호만 쓸 수 있습니다. snapshotText()를 부를 때마다 번호표 대장(refMap)을 새로 만들기 때문입니다.
에이전트가 Unknown ref(모르는 번호표) 오류를 만났다면 흔한 원인은 셋입니다.
| 원인 | 쉽게 말하면 |
|---|---|
| 요소가 화면 밖으로 밀려남 | 스크롤하면서 그 요소가 보이는 영역에서 벗어났습니다. |
| 페이지가 다시 그려짐 | 페이지 구조(DOM)가 새로 만들어졌습니다. |
| 지난번에 “보이는 영역만” 읽음 | 앞 차례에서 scope: 'only_within_viewport'로 읽었고, 다음 차례에서 그 요소가 읽은 범위에 들지 않았습니다. |
여러 차례에 걸쳐 같은 요소를 흔들림 없이 가리켜야 할 때는 번호표 대신 스냅샷에 함께 나오는 loc=... 선택자(스냅샷이 요소마다 함께 적어 주는 주소 표기)를 쓰거나 CSS 선택자를 직접 씁니다. 번호표의 기본 설명은 3장, 이 오류를 만났을 때 내가 할 일은 활용편 10에 있습니다.
번호가 정해지는 방식
번호는 요소의 CDP backendNodeId(브라우저가 요소마다 매겨 둔 내부 번호)에서 옵니다. 그래서 같은 요소는 스냅샷을 다시 읽어도 보통 같은 번호를 가집니다. 하지만 @N으로 동작하려면 N이 가장 최근 스냅샷 출력에 있어야 합니다. loc=... 선택자는 뒤에 나올 경험 쌓기의 바탕이기도 합니다.
경험 쌓기 — 곧 제공 예정
곧 제공 예정 · 제한 베타 브라우저 작업에서 에이전트의 시간과 비용은 대부분 시행착오에 들어갑니다. 통하는 방법을 찾을 때까지 이것저것 해 보아야 하기 때문입니다. 경험 쌓기(Experience accumulation)는 작업이 성공했을 때 그 방법을 웹사이트별로 저장해 두었다가, 다음에 같은 사이트에서 일할 때 다시 쓰게 하는 기능입니다.
skill workspace — 경험이 저장되는 자리와 환경 변수
ego-browser는 바뀌는 에이전트 경험을 스스로 품고 있지 않습니다. 기본으로는 저장소의 스킬 묶음에서 도우미 확장과 사이트별로 익힌 경험을 읽어 옵니다.
../../skills/ego-browser
환경 변수(프로그램에 넘겨주는 설정 값)로 위치를 바꿀 수 있습니다.
EGO_BROWSER_AGENT_WORKSPACE=/path/to/ego-browser ego-browser nodejs <<'EOF'
cliLog(await siteSkills())
EOF
learnings/ 아래의 사이트 경험은 항상 켜져 있고, 도우미를 부를 때마다 읽습니다. 경험을 쓰고 찾아내는 방식은 Skills 문서에서 설명한다고 되어 있으나, 받은 Skills 문서에는 위 “쓸수록 빨라진다” 소개까지만 있습니다.
익힌 경험을 검증하는 명령:
npm run validate:learnings
디렉터리 구조
package/ego-browser/
├── src/ # browser-runtime / helpers / run.js
│ ├── browser-runtime.js # ego runtime bridge on the browser side
│ ├── helpers.js # helpers exposed to the agent script
│ ├── run.js # CLI entry point (executes stdin)
│ └── learning/ # experience index, domain check, format check
├── artifacts/ego-browser/ # build output; npm bin points here
└── test/ # unit tests
skills/ego-browser/
├── SKILL.md / SKILL.zh.md # entry point for the agent
└── learnings/ # site experience directory
| 위치 | 역할 |
|---|---|
| src/browser-runtime.js | 브라우저 쪽에서 ego 실행 환경과 이어 주는 다리 |
| src/helpers.js | 에이전트 스크립트에 내주는 도우미 함수 |
| src/run.js | 명령줄 진입점. stdin(표준 입력 — 프로그램에 글을 흘려 넣는 통로)으로 받은 것을 실행 |
| src/learning/ | 경험 색인, 도메인 확인, 형식 확인 |
| artifacts/ego-browser/ | 빌드 결과물. npm의 실행 파일 연결이 여기를 가리킴 |
| test/ | 단위 테스트 |
| skills/ego-browser/SKILL.md · SKILL.zh.md | 에이전트가 처음 읽는 입구(스킬 설명서) |
| skills/ego-browser/learnings/ | 사이트 경험 폴더 |
안전 주의 — 진짜 조종 권한입니다
ego(lite)는 에이전트에게 진짜 브라우저 조종 권한을 줍니다. 흉내가 아니라 실제로 페이지 내용을 읽고 동작을 실행합니다. 그것도 내가 로그인해 둔 상태로 합니다.
에이전트가 할 수 있는 것
페이지 내용 읽기, 그리고 누르기·입력 같은 동작 실행.
내가 확인할 것
쓰는 에이전트가 믿을 수 있는 곳에서 온 것인지 확인합니다.
내가 할 수 있는 것
어느 Space에서 작업이 도는지 언제든 보고, 넘겨받거나 멈출 수 있습니다.
Space를 들여다보고 넘겨받는 방법, 로그인이 필요한 단계를 다루는 방법은 2장과 2장 로그인에서 설명합니다.
스크립트를 쓸 때 주의할 점
이 소절은 ego-browser 스크립트를 직접 쓰거나 에이전트가 쓴 것을 읽어 보려는 사람을 위한 것입니다. 원문이 꼽은 다섯 가지를 쉬운 말로 줄이면 이렇습니다.
| 주의 | 쉽게 말하면 |
|---|---|
| ① 스냅샷은 기본이 페이지 전체 | “보이는 영역만” 읽기는 정말 필요할 때만 씁니다. |
| ② 받은 결과를 다시 풀지 않는다 | js()가 돌려준 값은 이미 쓸 수 있는 꼴입니다. |
| ③ 역슬래시는 두 번 | 페이지 안 코드에 글자 패턴을 쓸 때 \를 겹쳐 씁니다. |
| ④ 복잡한 식은 미리 감싼다 | 값을 돌려주는 복잡한 코드는 처음부터 즉시 실행 함수(만들자마자 바로 실행되는 함수) 꼴로 씁니다. |
| ⑤ 미리 점검하지 않는다 | 내가 ego-browser를 쓰라고 했다면 준비는 끝난 것입니다. 바로 실행합니다. |
다섯 가지 주의 — 원문 그대로
snapshotText()의 기본값은scope: 'full_page'입니다. 보이는 영역만 정말 필요할 때에만'only_within_viewport'를 넘깁니다.js()는 실행 결과를 바로 돌려줍니다. 그 결과를 다시JSON.parse(...)하지 않습니다.js()의 템플릿 문자열(백틱`으로 감싼 여러 줄 글) 안에 정규식(글자 패턴을 찾는 표기)을 쓸 때는 역슬래시를 겹쳐 쓰거나(\\d,\\s)String.raw로 바꿉니다.- 맨 바깥의
return은 자동으로 IIFE로 감싸집니다. 안쪽 콜백(다른 함수에 넘겨주는 함수) 속return도 이 자동 감싸기를 일으킬 수 있으므로, 복잡한 식은 처음부터(() => { ... })()꼴로 씁니다. - 사용자가 ego-browser를 쓰라고 분명히 요청했다면 실행 환경은 준비되어 있습니다.
which ego-browser,node -v, 도움말 전체 출력 같은 사전 점검을 하지 않습니다. 첫 실행이 실제로 오류를 낼 때에만 합니다.
앞 소절에 흩어진 주의 사항 모아 보기
- 작업용 Space는 heredoc마다 선언하고, 이름은 3~6 단어의 자연스러운 작업 설명으로 짓습니다.
- heredoc 안(Node.js 프로세스)과
js(...)안(페이지)을 섞지 않습니다. js()에는 함수가 아니라 문자열을 넘깁니다.wait()와timeout은 초 단위이고,Ms로 끝나는 값만 밀리초입니다.- 모든 처리를 heredoc 하나 안에서 끝내고, 두 번째 node 스크립트로 넘기지 않습니다.
- @N은 가장 최근 스냅샷에 나온 번호만 씁니다.
- ego-browser는 에이전트가 ego(lite)를 조종할 때 쓰는 명령줄 도구입니다. 사람이 손으로 쓰는 도구도, Playwright·Puppeteer의 대체품도 아닙니다.
- 스킬은 그 사용법을 에이전트에게 알려 주는 설명서 묶음입니다. 내 에이전트가 내 로그인 상태로, 전용 Space에서 일하게 해 줍니다.
- 기본 흐름은 Space 준비 → 페이지 열기 → 스냅샷 읽기 → 동작하기 → 결과 출력이고, 이 전체를 스크립트 하나로 한 번에 실행합니다.
- 한 번에 실행하므로 모델과 주고받는 횟수가 줄어 작업이 일찍 끝나고 토큰을 덜 씁니다. Skills 문서의 내부 측정으로는 같은 작업이 20~50% 빨랐습니다.
- 번호표(@N)는 가장 최근 스냅샷에 나온 것만 통합니다.
Unknown ref오류는 대개 화면이 바뀐 뒤 옛 번호를 썼다는 뜻입니다. - 성공한 방법을 사이트별로 저장해 다시 쓰는 경험 쌓기는 곧 제공 예정(제한 베타)입니다.
- 에이전트는 진짜 브라우저 조종 권한을 가집니다. 믿을 수 있는 곳에서 온 에이전트만 쓰세요.
출처: lite.ego.app/document/en/docs/ego-browser · lite.ego.app/document/en/docs/skills · lite.ego.app/document/en/docs/product-introduce (ego-browser · Experience accumulation 절) · lite.ego.app (첫 화면 FAQ — Playwright·Puppeteer 비교, 토큰 절감) · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
에이전트별 연결 방법
ego(lite) 문서는 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램) 여덟 가지 — Claude Code, Codex, Cursor, OpenCode, WorkBuddy, Hermes Agent, OpenClaw, DeepSeek Harness — 를 ego(lite)에 연결하는 방법을 하나씩 따로 안내합니다. 순서는 어느 에이전트든 같고, 달라지는 것은 설정 이름과 위치, 그리고 입력하는 글자뿐입니다. 이 장은 공통 순서를 먼저 보인 뒤, 에이전트마다 다른 부분과 자주 막히는 곳을 정리합니다.
- 여덟 에이전트에 똑같이 적용되는 연결 순서 다섯 단계
- 에이전트마다 다른 세 가지 — 스킬을 읽는 폴더, 권한 설정의 이름과 위치, 스킬을 부르는 입력
- 내가 쓰는 에이전트의 데스크톱 앱과 터미널 화면에서 각각 따라 하는 방법
- 스킬이 안 보이거나 ego(lite)가 열리지 않을 때 확인할 것
어느 에이전트든 같은 다섯 단계
ego(lite)에 에이전트를 연결한다는 것은 새 프로그램을 설치하는 일이 아닙니다. ego(lite)가 에이전트에게 ego-browser 스킬(스킬 — 에이전트에게 주는 사용 설명서 묶음. ego-browser 는 ego(lite)를 조종하는 법을 담은 스킬)을 건네주고, 에이전트가 그 설명서대로 ego(lite)를 열어 일하게 만드는 것입니다. 여덟 문서 모두 아래 다섯 단계를 같은 순서로 밟습니다.
단계별로 눌러 보세요. 화면 그림은 모양만 흉내 낸 것이고, 실제 단추 이름과 위치는 에이전트마다 다릅니다(비교표).
① 준비 — ego(lite)를 설치하고, 에이전트를 껐다 켠다
- DMG 파일(macOS 설치 파일)을 내려받아 열고, 안내대로 ego(lite) 아이콘을 두 번 눌러 설치합니다.
- ego(lite)를 열고 첫 실행 설정(onboarding)을 끝까지 마칩니다. 이때 ego-browser 스킬이 내 컴퓨터에 설치됩니다.
- 에이전트가 이미 켜져 있었다면 완전히 종료했다가 다시 엽니다. 에이전트는 다시 열릴 때 스킬 목록을 새로 읽습니다.
설치를 처음 한다면 1장 설치부터 보세요.
② 권한 넓히기 — 승인 없이 실행하도록
에이전트는 보통 명령을 실행하기 전에 “해도 될까요?” 하고 묻습니다. ego(lite)를 조종하려면 이 확인을 건너뛰도록 권한을 넓혀야 합니다. 설정 이름은 에이전트마다 다릅니다.
Full accessCodex · DeepSeek Harness
Run EverythingCursor
Auto-accept permissionsOpenCode
Allow full accessWorkBuddy
Approval Mode → SmartHermes Agent
Exec Approvals 세 항목OpenClaw
③ 스킬 불러오기 — 설명서를 펴게 한다
에이전트의 대화 입력 칸에 /ego-browser(에이전트에 따라 /ego, /skill ego)를 입력하고, 목록에 나타나는 ego-browser를 고릅니다. 스킬을 불러오면 에이전트는 ego(lite)를 열고, 에이전트 Space(스페이스 — 에이전트 전용 작업 공간)를 만들고, 그 안에서 페이지를 다룰 수 있게 됩니다.
④ 일 맡기기 — 할 일을 글로 보낸다
여덟 문서가 모두 같은 작은 작업을 예로 듭니다. Anthropic의 X 프로필을 열어 글 다섯 개를 읽어 오는 일입니다. Hermes Agent 문서에 실린 문장은 이렇습니다.
Use ego-browser to open Anthropic's official X profile and collect the first five posts shown in the Posts feed.
뜻: ego-browser 로 Anthropic 공식 X 프로필을 열고, Posts(게시물) 목록에 보이는 처음 글 다섯 개를 모아 줘.
에이전트는 ego-browser 로 대상 페이지를 ego(lite)에서 열고, 요청받은 정보를 모은 뒤, 일이 끝나면 대화창에 결과를 돌려줍니다.
⑤ 결과 확인 — 답은 대화창에, 페이지는 ego(lite)에
일이 끝나면 에이전트 대화창에 글 다섯 개가 정리되어 나옵니다. 문서에 따르면 글마다 화면에 보이는 세부 정보, 바로 가는 링크, 짧은 요약이 함께 옵니다. Anthropic의 X 프로필 페이지는 ego(lite)에 열린 채로 남습니다. 에이전트가 무엇을 보고 답했는지 내가 원래 페이지에서 확인할 수 있습니다.
왜 권한을 넓혀야 할까요? ego-browser 는 에이전트가 내 컴퓨터에서 직접 실행하는 명령입니다. 이 명령이 ego(lite) 앱을 열고 브라우저 동작을 전달합니다. 권한이 좁으면 에이전트가 이 명령을 샌드박스(격리된 실행 칸) 안에 가두거나 실행 전마다 승인을 요청합니다. Codex 문서는 이 경우 ego(lite) 실행이 샌드박스에 막히거나 승인 요청에서 멈출 수 있다고 설명합니다.
스킬 이름을 꼭 입력해야 하나요? · 왜 “완전히” 종료해야 하나요?
- 스킬 이름 입력 — 대부분의 문서는
/ego-browser같은 입력으로 스킬을 직접 부르게 합니다. OpenClaw의 TUI(터미널 안에서 글자로 쓰는 화면)와 DeepSeek Harness는 작업 글의 뜻을 보고 스킬을 스스로 고를 수 있어, 작업 글에 “ego-browser 스킬을 써라”고 적는 것으로도 된다고 설명합니다. - 완전히 종료 — OpenClaw 문서는 세션(에이전트와 나누는 대화 한 판)이나 창만 닫아서는, DeepSeek Harness 문서는 새 세션만 시작해서는 스킬이 다시 읽히지 않을 수 있다고 적습니다. 그래서 프로그램 자체를 끝냈다가 다시 실행합니다.
에이전트별 한눈 비교표
다섯 단계는 같지만 에이전트마다 세 가지가 다릅니다. 스킬을 어느 폴더에서 읽는지, 권한 설정이 어디에 어떤 이름으로 있는지, 스킬을 무슨 글자로 부르는지입니다. 먼저 폴더부터 봅니다. ego(lite)의 첫 실행 설정은 스킬을 두 폴더에 설치하는데, 그 폴더를 그대로 읽는 에이전트가 있고 자기 폴더에서만 읽는 에이전트가 있습니다.
~ 는 내 홈 폴더를 뜻합니다. WorkBuddy와 Hermes Agent는 /ego-browser 가 보이지 않으면 스킬 폴더를 자기 폴더로 복사해 주어야 합니다.아래 표에서 내 에이전트의 줄만 보면 됩니다. “데스크톱 앱의 권한 설정”과 “터미널 실행 명령”은 같은 일을 하는 두 길이므로, 내가 쓰는 화면 쪽 하나만 하면 됩니다. 터미널(글자로 명령을 입력하는 창)에서 에이전트를 쓰는 TUI(터미널 안에서 글자로 쓰는 화면)가 아니라면 터미널 칸은 건너뛰세요. 여기 없는 에이전트(직접 만든 에이전트 프로그램, 내 컴퓨터에서 도는 모델)는 6장에서 다룹니다.
| 에이전트 | 스킬을 읽는 폴더 | 데스크톱 앱의 권한 설정 | 터미널 실행 명령 | 스킬을 부르는 입력 | 이것만은 주의 |
|---|---|---|---|---|---|
| Claude Code | ~/.claude/skills/ | 입력 칸 옆 권한 선택기 → Bypass permissions | claude --dangerously-skip-permissions | /ego-browser | Cowork 가 아니라 Code 모드 |
| Codex | ~/.agents/skills/ | 입력 칸 왼쪽 아래 권한 선택기 → Full access | codex --dangerously-bypass-approvals-and-sandbox | /ego → ego-browser 선택 | ChatGPT 데스크톱 앱이면 Codex 모드로 |
| Cursor | ~/.agents/skills/ | Settings → Agents → Approvals & Execution → Run Everything | 문서에 없음 | /ego → ego-browser 선택 | 자체 Browser 창과 다른 길. 3.6 이전 화면은 Run Everything (Unsandboxed) |
| OpenCode | ~/.agents/skills/ | Settings → General → Auto-accept permissions | opencode --auto | /ego-browser 또는 @ego-browser | 스킬을 따로 한 메시지로 먼저 보냄 |
| WorkBuddy | ~/.codebuddy/skills/안 보이면 복사 | 입력 칸 아래 권한 메뉴 → Allow full access | codebuddy --dangerously-skip-permissions | /ego-browser | 터미널 쪽 이름은 CodeBuddy Code |
| Hermes Agent | ~/.hermes/skills/안 보이면 복사 | Settings → Safety → Approval Mode → Smart | hermes --tui --yolo | /ego-browser + 한 칸 띄우기 | 안 띄우면 “모르는 명령” 오류 |
| OpenClaw | ~/.agents/skills/ | Settings → Exec Approvals 의 세 항목 | openclaw exec-policy preset yolo 다음에 openclaw tui | /skill ego → /ego_browser | 이름에 밑줄. /ego 는 없는 명령 |
| DeepSeek Harness | ~/.agents/skills/ · 프로젝트 안 .agents/skills/ | (Web UI) 입력 칸 아래 권한 메뉴 → Full access | DSH_PERMISSION_MODE=danger-full-access dsh --profile headless "…" | /ego-browser | 데스크톱 앱·TUI 없이 Web UI(웹 브라우저에서 여는 대화 화면)와 headless(대화 화면 없이 도는) 명령 |
Claude Code
Claude Code는 데스크톱 앱과 터미널 두 곳에서 쓸 수 있고, ego(lite)는 내 컴퓨터에서 도는 Code 세션(세션 — 에이전트와 나누는 대화 한 판)에서 조종합니다. 처음에 가장 많이 헷갈리는 곳은 데스크톱 앱입니다. 같은 앱 안에 Cowork 와 Code 두 모드가 함께 있는데, /ego-browser 는 Code 에서만 나타납니다.
/ego-browser 가 안 보인다고 해서 설치가 실패한 것은 아닙니다.
CoworkCode
준비 — ego(lite)를 설치하고 첫 실행 설정을 마칩니다. 그때 Claude 가 켜져 있었다면 종료했다가 다시 열어 스킬 목록을 새로 읽게 합니다.
- 권한Code 세션의 입력 칸 옆 권한 선택기를 열고 Bypass permissions(권한 확인 건너뛰기)를 고릅니다. 켜 두면 Claude Code가 단계마다 확인을 기다리지 않고 내 컴퓨터에서 명령을 실행해 ego(lite)를 열고 브라우저 작업을 합니다.
- 스킬
/ego-browser를 입력하고 스킬을 고릅니다. 불러오면 ego(lite)를 열고, 에이전트 Space를 만들고, 그 안에서 페이지를 다룰 수 있습니다. - 맡기기할 일을 보냅니다. Claude Code가 ego-browser 로 ego(lite)에서 대상 페이지를 열고 정보를 모아 옵니다.
터미널에 입력할 명령
claude --dangerously-skip-permissions
- 권한터미널에서 위 명령으로 Claude Code를 시작합니다. 화면이 열리면 상태 줄(지금 상태를 알려 주는 줄)에
bypass permissions on이 보입니다. - 스킬 + 맡기기
/ego-browser를 입력하고 스킬 이름 뒤에 한 칸을 띄운 다음 같은 메시지에 할 일을 이어 적어 보냅니다. Claude Code가 스킬을 불러오고 바로 작업을 시작합니다.
결과 — 대화창에 글 다섯 개가 링크, 페이지에 보이는 좋아요 수, 주요 주제 요약과 함께 돌아옵니다. Anthropic의 X 프로필은 출처를 확인할 수 있게 ego(lite)에 열린 채로 남습니다.
| Claude Code에서 자주 막히는 곳 | 푸는 법 |
|---|---|
/ego-browser 가 없음 | 세션이 Cowork 가 아니라 Code 인지 확인합니다. Claude 가 켜진 채로 ego(lite) 첫 실행 설정을 마쳤다면 Claude 를 다시 시작하고 /ego 를 다시 입력합니다. |
| Bypass permissions 가 목록에 없음 | Settings → Claude Code 에서 Allow bypass permissions mode(권한 확인 건너뛰기 모드 허용)를 켭니다. Team·Enterprise 정책(조직 관리자가 정해 둔 사용 규칙)이 이 항목을 숨길 수 있으니, 잠겨 있으면 관리자에게 문의합니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 입력 칸 옆 권한 모드를 확인합니다. Bypass permissions 가 켜져 있어야 ego(lite)를 정상적으로 조종할 수 있습니다. 데스크톱 앱은 권한 선택기에서 다시 고르고, 터미널은 세션을 닫고 claude --dangerously-skip-permissions 로 다시 시작합니다. |
| X 가 로그인·인증을 요구함 | ego(lite)의 에이전트 Space에서 내가 넘겨받아 로그인이나 인증을 직접 마친 뒤, Claude Code에게 계속하라고 말합니다. 비밀번호나 인증 코드를 프롬프트(에이전트에게 보내는 글)에 붙여 넣지 않습니다. |
Claude Code — 스킬 경로 · 그래도 안 될 때 · 공식 권한 문서
- 첫 실행 설정은 ego-browser 스킬을
~/.claude/skills/에 씁니다. - 위 방법을 다 해도 Claude 가 ego(lite)를 조종하지 못하면, 문서는 ego(lite) Discord 로 연락해 달라고 안내합니다.
- 지금 쓰이는 권한 모드는 Anthropic의 Claude Code Desktop 권한 문서에서 확인하라고 원문이 안내합니다.
Codex
Codex는 데스크톱 앱과 터미널 화면 어느 쪽에서든 ego(lite)를 조종할 수 있고, 두 화면에서 같은 스킬과 같은 작업 글을 씁니다. 준비는 같습니다. ego(lite) 첫 실행 설정을 마친 뒤 Codex를 열고, 이미 켜져 있었다면 종료했다가 다시 엽니다.
- 시작프로젝트를 열고 새 작업을 시작합니다.
- 권한입력 칸 왼쪽 아래의 권한 선택기를 열어 Full access(전체 접근)를 고르고, 나타나는 경고를 확인합니다. 이 설정이 있어야 ego-browser 가 내 컴퓨터의 ego(lite) 앱을 열고 브라우저 명령을 보낼 수 있습니다.
- 스킬입력 칸에
/ego를 입력하고 스킬 선택 목록에서 ego-browser를 고릅니다./ego-browser를 다 입력하고 Tab 을 눌러도 됩니다. - 맡기기할 일을 보냅니다.
터미널에 입력할 명령
codex --dangerously-bypass-approvals-and-sandbox
- 시작 + 권한프로젝트 폴더에서 터미널을 열고 위 명령으로 새 세션을 시작합니다. 승인 요청과 샌드박스를 건너뛴 상태로 Codex가 열립니다.
- 스킬 + 맡기기
/ego를 입력해 ego-browser를 고르고, 할 일을 덧붙여 보냅니다. 스킬이 ego(lite)를 시작하고 에이전트 Space를 만들어 그 안에서 페이지를 다룹니다.
스킬을 불러온 Codex는 ego(lite)에서 Space를 새로 만들거나 이미 있는 Space를 조종하고, 그 안에서 페이지를 열고 다룹니다. 내가 쓰는 탭은 가져가지 않습니다. 일이 끝나면 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 돌아오고, X 프로필은 ego(lite)에 열린 채로 남습니다.
| Codex에서 자주 막히는 곳 | 푸는 법 |
|---|---|
| ego-browser 가 안 나타남 | ego(lite) 첫 실행 설정을 마치고, Codex를 종료했다가 다시 엽니다. /ego 를 입력해 ego-browser 를 고릅니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 데스크톱 앱은 입력 칸 옆에 Full access 가 표시되어 있는지 확인합니다. 터미널은 세션을 닫고 codex --dangerously-bypass-approvals-and-sandbox 로 다시 시작합니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 내가 넘겨받아 직접 마친 뒤, Codex에게 같은 Space에서 계속하라고 말합니다. 비밀번호나 인증 코드를 프롬프트에 붙여 넣지 않습니다. |
Codex — 스킬 경로 · 공식 권한 문서
- 첫 실행 설정은 ego-browser 스킬을
~/.agents/skills/에 씁니다. 스킬이 안 보이면 이 폴더에 설치되어 있어야 합니다. - 터미널 화면을 쓰려면 Codex CLI(터미널용 Codex 프로그램)를 따로 설치해 두어야 합니다.
- 샌드박스와 승인이 어떻게 동작하는지는 OpenAI의 안전 안내 문서(How Codex sandboxing and approvals work)를 보라고 원문이 안내합니다.
Cursor
Cursor에는 자체 Browser 창이 딸려 있지만, 여기서 다루는 것은 그와 다른 길입니다. ego-browser 스킬이 ego(lite)를 실행하고, 따로 마련된 에이전트 Space에서 일하며, 그곳에서 쓸 수 있는 로그인 상태를 이용합니다. 그래서 평소 쓰던 브라우저의 로그인이 필요한 작업에 잘 맞습니다.
- 준비ego(lite) 첫 실행 설정을 마친 뒤, Cursor에서 믿을 수 있는 프로젝트나 폴더를 엽니다. 설정 도중에 Cursor가 켜져 있었다면 종료했다가 다시 열어 스킬 선택 목록을 새로 읽게 합니다.
- 권한Settings → Agents → Approvals & Execution(설정 → 에이전트 → 승인과 실행)을 열고 Run Everything(모두 실행)을 고릅니다. 원문은 이 단계를 “Full access 켜기”라고 부르지만, 고르는 항목 이름은 Run Everything 입니다.
- 스킬Agent 패널을 열고 입력 칸에
/ego를 입력한 뒤, 나타나는 ego-browser를 고릅니다. 이제 스킬이 ego(lite)를 열고 에이전트 Space를 만들어 그 안의 페이지를 다룹니다. 내가 평소 쓰는 탭은 따로 그대로 있습니다. - 맡기기할 일을 보냅니다. Cursor Agent가 ego-browser 로 Anthropic의 X 프로필을 ego(lite)에서 열고, 글을 읽어 Cursor 대화에 결과를 정리합니다.
결과 — 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 돌아오고, X 프로필은 ego(lite)에 열린 채로 남습니다.
| Cursor에서 자주 막히는 곳 | 푸는 법 |
|---|---|
| ego-browser 가 안 나타남 | ego(lite) 첫 실행 설정을 마치고, Cursor를 종료했다가 다시 엽니다. Agent 패널에서 /ego 를 입력합니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | Cursor 3.6 이상은 Settings → Agents → Approvals & Execution → Run Everything 을 확인합니다. 문서 영상에 나오는 이전 화면에서는 Ask Every Time(매번 묻기) 대신 Run Everything (Unsandboxed) 를 고릅니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 내가 넘겨받아 직접 마친 뒤, Cursor에게 같은 Space에서 계속하라고 요청합니다. 비밀번호나 인증 코드를 프롬프트에 붙여 넣지 않습니다. |
Cursor — 스킬 경로 · 공식 권한 문서
- 첫 실행 설정은 ego-browser 를
~/.agents/skills/에 씁니다. 스킬이 안 보이면 이 폴더에 설치되어 있어야 합니다. - Cursor 문서는 데스크톱 화면만 안내하며, 터미널 화면에서 쓰는 방법은 싣지 않았습니다.
- 지금의 실행 방식 이름과 동작은 Cursor의 Agent 보안 문서(Cursor Agent security)에서 확인하라고 원문이 안내합니다.
OpenCode
OpenCode는 데스크톱 앱과 터미널 화면 양쪽에서 ego(lite)를 조종할 수 있습니다. OpenCode는 ego(lite)가 스킬을 설치하는 폴더를 그대로 읽으므로 복사할 것은 없습니다. ego(lite) 첫 실행 설정을 마치고, OpenCode가 켜져 있었다면 종료했다가 다시 연 뒤 시작합니다.
- 시작프로젝트를 열고 새 세션을 시작합니다.
- 권한Settings → General(설정 → 일반)에서 Auto-accept permissions(권한 자동 수락)를 켭니다. 에이전트가 승인을 기다리며 멈추지 않고 ego(lite)를 시작하고 브라우저 명령을 보낼 수 있게 하는 설정입니다.
- 스킬OpenCode 버전에 따라
/ego-browser또는@ego-browser를 입력하고, 목록에서 ego-browser를 골라 그것만 먼저 보냅니다. - 맡기기스킬이 불러와지면 다음 메시지로 할 일을 보냅니다.
터미널에 입력할 명령
opencode --auto
- 시작 + 권한프로젝트 폴더에서 터미널을 열고 위 명령을 실행합니다.
--auto는 자동 승인을 켠 채로 시작하라는 뜻입니다. 명령 팔레트(명령 목록 창)를 열어 Enable auto-approve permissions 를 골라도 됩니다. - 스킬 → 맡기기터미널 세션에서 ego-browser 스킬을 불러온 다음 할 일을 보냅니다. 스킬의 동작은 데스크톱 앱에서와 같습니다.
결과 — 할 일을 보낸 뒤의 과정은 두 화면이 같습니다. 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 돌아오고, X 프로필은 ego(lite)에 열린 채로 남습니다.
| OpenCode에서 자주 막히는 곳 | 푸는 법 |
|---|---|
| ego-browser 가 안 나타남 | ego(lite) 첫 실행 설정을 마치고, OpenCode를 종료했다가 다시 엽니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 데스크톱 앱은 Settings → General → Auto-accept permissions 를 확인합니다. 터미널은 세션을 닫고 opencode --auto 로 다시 시작합니다. |
| TUI가 엉뚱한 프로젝트에서 열림 | OpenCode를 끝내고, 터미널에서 프로젝트 폴더로 이동한 뒤 opencode --auto 를 다시 실행합니다. OpenCode는 명령을 실행한 현재 폴더를 프로젝트로 삼습니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 로그인이나 인증을 내가 직접 마친 뒤, OpenCode에게 작업을 계속하라고 요청합니다. 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
OpenCode — 스킬 경로 · 공식 문서
- 첫 실행 설정은 ego-browser 를
~/.agents/skills/에 쓰고, OpenCode는 이 폴더에서 스킬을 찾습니다. - 지금의 자동 승인 방식과 권한 설정은 OpenCode 권한 문서에서, 스킬을 찾는 위치는 OpenCode Agent Skills 문서에서 확인하라고 원문이 안내합니다.
WorkBuddy
WorkBuddy는 데스크톱 앱에서, 또는 터미널의 CodeBuddy Code를 통해 ego(lite)를 조종합니다. 두 곳에서 같은 /ego-browser 를 씁니다. 준비 단계에서 다른 에이전트와 다른 점이 하나 있습니다.
~/.agents/skills/ 에 설치하는데, WorkBuddy와 CodeBuddy Code는 사용자 스킬을 ~/.codebuddy/skills/ 에서 읽습니다. /ego-browser 가 나타나지 않으면 설치된 스킬을 WorkBuddy의 스킬 폴더로 복사하고 WorkBuddy를 다시 시작합니다. 복사 명령은 바로 아래 접힌 상자에 있습니다.
WorkBuddy — 스킬 폴더 복사 명령
터미널에 아래 두 줄을 그대로 붙여 넣습니다. 첫 줄은 WorkBuddy 쪽에 폴더를 만들고, 둘째 줄은 ego(lite)가 설치한 스킬 내용을 그 폴더로 복사합니다.
mkdir -p ~/.codebuddy/skills/ego-browser
cp -R ~/.agents/skills/ego-browser/. ~/.codebuddy/skills/ego-browser/
복사가 잘 되었다면 ~/.codebuddy/skills/ego-browser/SKILL.md 파일이 있어야 합니다.
- 시작작업 공간(workspace)을 고르고 새 작업을 시작합니다.
- 권한작업 입력 칸 아래의 권한 메뉴를 열어 Default Permission(기본 권한)을 Allow full access(전체 접근 허용)로 바꿉니다. 에이전트가 단계마다 승인을 기다리지 않고 ego(lite)를 시작하고 브라우저 명령을 보낼 수 있게 됩니다.
- 스킬 + 맡기기
/ego-browser를 입력하고 목록에서 ego-browser를 고릅니다. WorkBuddy가 스킬을 지금 쓰는 메시지에 이름표처럼 붙여 줍니다. 같은 메시지에 할 일을 이어 쓰고 보냅니다.
터미널에 입력할 명령
codebuddy --dangerously-skip-permissions
- 시작 + 권한프로젝트 폴더로 이동한 뒤 위 명령으로 CodeBuddy Code를 시작합니다. 화면이 열리면 상태 줄에
bypass permissions on이 보이는지 확인합니다. - 스킬 → 맡기기터미널 세션에서 ego-browser 를 불러온 다음 할 일을 보냅니다. 같은 작업을 데스크톱 앱과 터미널 어느 쪽에서든 맡길 수 있습니다.
결과 — 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 돌아오고, X 프로필은 ego(lite)에 열린 채로 남습니다.
| WorkBuddy에서 자주 막히는 곳 | 푸는 법 |
|---|---|
| ego-browser 가 안 나타남 | WorkBuddy의 스킬 폴더에 스킬이 있는지 확인하고(위 접힌 상자), WorkBuddy나 CodeBuddy Code를 완전히 종료했다가 다시 엽니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 데스크톱 앱은 권한 메뉴에 Allow full access 가 표시되는지 확인합니다. 터미널은 세션을 닫고 --dangerously-skip-permissions 를 붙여 CodeBuddy Code를 다시 시작합니다. |
터미널이 codebuddy 명령을 못 찾음 | WorkBuddy 앱에 들어 있는 CLI(터미널에서 쓰는 명령 도구)를 쓰거나, CodeBuddy Code를 전역으로 설치(어느 폴더에서든 이름만으로 실행되게 설치)한 뒤 짧은 codebuddy 명령을 씁니다(경로는 아래 접힌 상자). |
| TUI가 엉뚱한 프로젝트에서 열림 | CodeBuddy Code를 끝내고, 맞는 프로젝트 폴더로 이동한 뒤 명령을 다시 실행합니다. 명령을 실행한 현재 폴더가 프로젝트가 됩니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 로그인이나 인증을 내가 직접 마친 뒤, WorkBuddy에게 작업을 계속하라고 요청합니다. 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
WorkBuddy — 앱에 들어 있는 CLI 경로 · 공식 문서
CodeBuddy Code를 전역으로 설치하지 않고 WorkBuddy macOS 앱에 들어 있는 CLI를 쓰려면 이렇게 실행합니다.
"/Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy" \
--dangerously-skip-permissions
권한 방식은 WorkBuddy 권한 모드 문서(데스크톱)와 CodeBuddy Code 권한 문서(TUI의 권한 모드와 시작 옵션)에서, 스킬을 읽는 위치는 CodeBuddy Code 스킬 문서에서 확인하라고 원문이 안내합니다.
Hermes Agent
Hermes Agent도 데스크톱 앱과 터미널 화면 양쪽에서 ego(lite)를 조종합니다. 주의할 곳이 두 군데입니다. WorkBuddy처럼 스킬 폴더를 복사해야 할 수 있고, 스킬 이름과 작업 사이에 띄어쓰기가 꼭 있어야 합니다.
~/.agents/skills/ 에 설치하는데, Hermes는 사용자 스킬을 ~/.hermes/skills/ 에서 불러옵니다. /ego-browser 가 나타나지 않으면 스킬을 Hermes 폴더로 복사하고 Hermes를 다시 시작합니다(명령은 아래 접힌 상자).② 띄어쓰기 —
/ego-browser 와 할 일 사이를 한 칸 띄웁니다. 붙여 쓰면 Hermes가 스킬 이름과 작업의 첫 단어를 한 명령으로 읽어 /ego-browserUse 같은 “모르는 명령” 오류를 냅니다.
/ego-browser Use ego-browser to open Anthropic's official X profile and collect the first five posts shown in the Posts feed.
뜻: (ego-browser 스킬을 불러와서) ego-browser 로 Anthropic 공식 X 프로필을 열고, Posts(게시물) 목록에 보이는 처음 글 다섯 개를 모아 줘. — /ego-browser 바로 뒤의 빈칸에 주목하세요.
Hermes Agent — 스킬 폴더 복사 명령
터미널에 아래 두 줄을 그대로 붙여 넣습니다. 첫 줄은 Hermes 쪽에 폴더를 만들고, 둘째 줄은 스킬 내용을 복사합니다.
mkdir -p ~/.hermes/skills/ego-browser
cp -R ~/.agents/skills/ego-browser/. ~/.hermes/skills/ego-browser/
복사가 잘 되었다면 ~/.hermes/skills/ego-browser/SKILL.md 파일이 있어야 합니다. 이미 열려 있는 TUI 세션에서는 /reload-skills 를 실행하고 새 세션을 시작하는 방법도 있습니다.
- 시작작업 공간(workspace)을 열고 새 세션을 시작합니다.
- 권한Settings → Safety(설정 → 안전)를 열고 Approval Mode(승인 방식)를 Smart 로 맞춥니다.
- 스킬 + 맡기기
/ego-browser를 입력하고 목록에서 ego-browser를 고른 뒤, 스킬 이름 뒤에 한 칸 띄우고 할 일을 이어 써서 보냅니다.
터미널에 입력할 명령
hermes --tui --yolo
- 시작 + 권한프로젝트 폴더에서 터미널을 열고 위 명령을 실행합니다.
--yolo는 승인 요청을 건너뛴 채로 TUI를 시작하라는 뜻입니다. - 스킬 + 맡기기터미널 세션에서 ego-browser 를 불러오고, 스킬 이름 뒤에 한 칸 띄운 다음 할 일을 입력합니다. 같은 작업이 데스크톱 앱과 TUI에서 똑같이 동작합니다.
결과 — 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 돌아오고, X 프로필은 ego(lite)에 열린 채로 남습니다.
| Hermes Agent에서 자주 막히는 곳 | 푸는 법 |
|---|---|
| ego-browser 가 안 나타남 | Hermes의 스킬 폴더에 스킬이 있는지 확인하고(위 접힌 상자) Hermes를 다시 시작합니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 데스크톱 앱은 Settings → Safety → Approval Mode 가 Smart 인지 확인합니다. 터미널은 세션을 닫고 hermes --tui --yolo 로 다시 시작합니다. |
/ego-browserUse 같은 모르는 명령이라고 나옴 | /ego-browser 뒤에 한 칸을 띄우거나, 추천 목록에서 스킬을 먼저 고른 다음 할 일을 씁니다. |
| TUI가 엉뚱한 프로젝트에서 열림 | Hermes를 끝내고, 맞는 프로젝트 폴더로 이동한 뒤 hermes --tui --yolo 를 다시 실행합니다. Hermes는 현재 폴더를 새 세션의 작업 공간으로 씁니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 로그인이나 인증을 내가 직접 마친 뒤, Hermes Agent에게 작업을 계속하라고 요청합니다. 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
공식 승인 방식과 --yolo 에 해당하는 설정은 Hermes Agent 설정 문서에서, 스킬을 찾고 불러오는 방식은 Hermes Agent 스킬 문서에서 확인하라고 원문이 안내합니다.
OpenClaw
OpenClaw는 macOS 앱과 터미널 화면 양쪽에서 ego(lite)를 조종합니다. 시작 전에 OpenClaw가 동작하는 AI 모델에 연결되어 있어야 하고, ego(lite)를 설치한 뒤에는 OpenClaw를 완전히 종료했다가 다시 실행해야 합니다. 지금 세션이나 창만 닫아서는 새로 설치된 스킬이 읽히지 않을 수 있습니다.
/ego_browser (밑줄)
OpenClaw는 스킬을 직접 부르는 명령에서 하이픈(-)을 밑줄(_)로 바꿔 보여 줍니다. 그래서 목록에 보이는 명령은 /ego-browser 가 아니라 /ego_browser 입니다. 그리고 /ego 는 OpenClaw에 없는 명령이라 명령 목록에 나오지 않는 것이 정상입니다. /skill ego 를 입력해 찾으세요.
- 스킬 확인Settings → Skills(설정 → 스킬)에서 ego-browser 가 Ready(준비됨)로 표시되고 켜져 있는지 봅니다.
- 권한Command + , (macOS)로 Settings 를 열고 Exec Approvals(실행 승인)를 고릅니다. main 범위와 Access 를 고른 뒤, 이 목록 아래 그림의 세 항목을 맞춥니다.
- 스킬 + 맡기기새 세션에서
/skill ego를 입력하고 추천 목록에서/ego_browser를 고릅니다. 그 뒤에 할 일을 이어 쓰거나 붙여 넣고 보냅니다./skill ego-browser로 직접 불러도 됩니다.
| 항목 | 맞출 값 |
|---|---|
| Command access (명령 실행 허용) | Always Allow |
| Prompt behavior (물어보는 방식) | Never Ask |
| Fallback when unreachable (승인 화면에 닿지 못할 때) | Always Allow |
터미널에 입력할 명령
openclaw exec-policy preset yolo
openclaw tui
- 권한 + 시작TUI를 열기 전에 OpenClaw의 공식 “승인 없음” 사전 설정을 적용하고(위 첫 줄), 이어서 TUI를 엽니다(둘째 줄).
- 맡기기할 일 전체를 한 번에 보내되, ego-browser 스킬을 쓰라고 글에 적습니다. OpenClaw가 작업의 뜻을 보고 켜져 있는 스킬을 고르므로 따로 명령을 입력할 필요가 없습니다. 직접 지정하고 싶으면
/skill ego-browser를 씁니다.
결과 — 할 일을 보낸 뒤의 브라우저 작업 과정은 두 화면이 같습니다. 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 돌아오고, X 프로필은 ego(lite)에 열린 채로 남습니다.
| OpenClaw에서 자주 막히는 곳 | 푸는 법 |
|---|---|
/ego 가 명령 목록에 없음 | 정상입니다. 데스크톱 앱에서는 /skill ego 를 입력해 /ego_browser 를 고르고, TUI에서는 /skill ego-browser 를 쓰거나 ego-browser 스킬을 쓰라고 분명히 적은 보통의 작업 글을 보냅니다. |
| ego-browser 가 Ready 가 아님 | 스킬 파일이 있는지 확인하고, 데스크톱 앱의 Settings → Skills 에서 Refresh(새로 고침)를 누른 뒤 ego-browser 가 켜져 있는지 봅니다. 그다음 새 세션을 시작합니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 데스크톱 앱은 Exec Approvals 의 세 항목을 다시 확인합니다. TUI는 세션을 끝내고 openclaw exec-policy preset yolo 를 실행한 뒤 openclaw tui 로 다시 엽니다. |
| TUI가 Gateway 에 연결하지 못함 | openclaw gateway status 로 상태를 봅니다. Gateway 가 돌고 있지 않으면 openclaw gateway start 로 시작한 뒤 openclaw tui 를 다시 실행합니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 로그인이나 인증을 내가 직접 마친 뒤, OpenClaw에게 작업을 계속하라고 요청합니다. 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
OpenClaw — 스킬 경로 · yolo 사전 설정이 하는 일 · 공식 문서
- ego(lite)는 ego-browser 를
~/.agents/skills/에 설치하고, OpenClaw는 개인용 스킬을 이 폴더에서 읽습니다. 스킬이 준비되지 않았다면~/.agents/skills/ego-browser/SKILL.md가 있는지 확인합니다. yolo사전 설정은 호스트 실행(ego(lite)가 설치된 바로 그 컴퓨터에서 명령을 실행하는 것)을security=full로 두고, 승인 요청을 끄고, 승인 화면을 쓸 수 없을 때에도 실행이 이어지게 합니다.- 터미널 화면(TUI)을 쓰려면 OpenClaw CLI(터미널용 OpenClaw 프로그램)를 설치해 두어야 합니다.
- 승인 없음 정책과 yolo 사전 설정은 OpenClaw exec approvals 문서에서, 스킬 위치와 TUI 명령, 설치 방법은 각각 OpenClaw Skills · TUI · 설치 문서에서 확인하라고 원문이 안내합니다.
DeepSeek Harness
DeepSeek Harness는 지금 따로 설치하는 데스크톱 앱이나 내장 TUI가 없습니다. 그래서 문서는 다른 두 가지 길을 씁니다. 내 컴퓨터에서 열리는 Web UI(웹 브라우저에서 여는 대화 화면)와, 터미널 명령 한 줄로 작업 하나를 돌리고 끝나는 headless 프로필입니다.
준비 — ego(lite) 첫 실행 설정을 마치고, Node.js(문서가 준비물로 꼽는 프로그램)를 설치하고, DeepSeek Harness를 실행해 Settings → Models(설정 → 모델)에서 모델을 연결합니다. ego(lite)를 설치한 뒤에는 DeepSeek Harness를 완전히 멈췄다가 다시 실행합니다. 새 세션만 시작해서는 스킬이 다시 읽히지 않을 수 있습니다.
터미널에 입력할 명령
npx @deepseek-ai/dsh web
- 시작프로젝트 폴더에서 터미널을 열고 위 명령을 실행하면 Web UI가
http://127.0.0.1:3080에서 열립니다.dsh를 전역으로 설치(어느 폴더에서든 이름만으로 실행되게 설치)해 두었다면dsh web으로도 됩니다. - 권한입력 칸 아래의 권한 메뉴에서 Full access(전체 접근)를 고릅니다. 경고를 읽고, 확인란에 체크한 뒤, Enable Full access 를 누릅니다.
- 스킬 + 맡기기입력 칸에
/ego-browser를 입력하고 추천 목록에서 같은 이름의 스킬을 고릅니다. 스킬 이름 뒤에 할 일을 이어 쓰거나 붙여 넣고 보냅니다. - 기다리기DeepSeek Harness가 스킬을 불러오고 ego-browser 명령을 실행해, 따로 마련된 에이전트 Space에서 Anthropic의 X 프로필을 엽니다. 에이전트가 글을 읽고 답을 준비하는 동안 Web UI를 열어 둡니다.
권한 설정과 작업 글을 명령 한 줄에 함께 적습니다. 앞의 DSH_PERMISSION_MODE=danger-full-access 가 이번 실행에 한해 승인 없이 실행하도록 하는 부분이고, 끝의 따옴표 안이 맡길 일입니다(설정 값이 아닙니다).
DSH_PERMISSION_MODE=danger-full-access dsh --profile headless \
"Use the ego-browser skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed."
뜻: ego-browser 스킬을 써서 Anthropic 공식 X 프로필을 열고, Posts(게시물) 목록에 보이는 처음 글 다섯 개를 모아 줘.
작업 글이 이미 ego-browser 스킬을 쓰라고 말하고 있으므로 따로 스킬을 부르지 않아도 됩니다. 분명히 부르고 싶으면 따옴표 안 맨 앞에 /ego-browser 를 넣습니다.
결과 — Web UI에서는 글 다섯 개가, 글마다 화면에 보이는 세부 정보·바로 가는 링크·짧은 요약과 함께 화면에 나옵니다. headless 에서는 최종 답을 터미널에 출력하고 끝납니다. 어느 쪽이든 Anthropic 프로필은 ego(lite)에 열린 채로 남습니다.
| DeepSeek Harness에서 자주 막히는 곳 | 푸는 법 |
|---|---|
/ego-browser 가 안 나타남 | 스킬 파일이 있는지 확인한 뒤, 원하는 프로젝트 폴더에서 DeepSeek Harness를 시작하고 새 세션을 만듭니다. |
| 작업이 권한 승인을 기다리며 멈춤 | Web UI는 일을 보내기 전에 지금 세션에 Full access 가 표시되어 있는지 확인합니다. 터미널은 DSH_PERMISSION_MODE=danger-full-access 가 같은 명령 안에서 dsh 앞에 있는지 확인합니다. |
터미널이 dsh 를 못 찾음 | dsh 자리에 npx @deepseek-ai/dsh 를 쓰는 형태로 실행합니다(전체 명령은 아래 접힌 상자). |
| 왜 데스크톱 앱이나 TUI 안내가 없나요? | DeepSeek Harness가 지금 공식으로 제공하는 것이 Web UI와 headless 프로필이기 때문입니다. Web UI는 내 컴퓨터에서 돌지만 브라우저에서 열리므로 따로 설치하는 데스크톱 앱이 아닙니다. TUI는 별도의 커뮤니티 플러그인이 있어야 해서 문서가 다루지 않습니다. |
| X 가 로그인·계정 확인을 요구함 | ego(lite)의 에이전트 Space에서 로그인이나 인증을 내가 직접 마친 뒤, 작업을 다시 실행합니다. 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다. |
DeepSeek Harness — 스킬 경로 · Full access 가 뜻하는 것 · dsh 가 없을 때 명령 · 공식 문서
- ego(lite)는 ego-browser 를
~/.agents/skills/에 설치합니다. DeepSeek Harness는 이 공용 사용자 스킬 폴더와, 지금 프로젝트 안의.agents/skills/(<project>/.agents/skills/)를 함께 살핍니다. 스킬이 안 보이면~/.agents/skills/ego-browser/SKILL.md가 있는지 확인합니다. - Full access 는
danger-full-access사전 설정에 해당합니다. 명령이 DeepSeek Harness의 샌드박스에 갇히지 않고, 승인 요청이 꺼집니다. headless 명령의 환경 변수(명령 앞에 붙여 그 실행에만 적용하는 설정 값)는 승인 정책을 never(묻지 않음)로 둔 같은 설정을 그 실행에만 켭니다. /ego-browser를 직접 입력하면 작업이 시작되기 전에 스킬이 먼저 불러와집니다.
dsh 를 찾지 못할 때 쓰는 명령입니다.
DSH_PERMISSION_MODE=danger-full-access npx @deepseek-ai/dsh --profile headless \
"Use the ego-browser skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed."
Full access · 샌드박스 방식 · 승인 정책은 DeepSeek Harness 권한 사전 설정 문서에서, Web UI와 모델 연결은 사용자 안내 문서에서 확인하라고 원문이 안내합니다.
공통으로 막히는 곳과 푸는 법
여덟 문서의 문제 해결 항목을 모아 보면 대부분 같은 네 가지 증상입니다. 아래 그림의 순서대로 물어보면 어디서 막혔는지 금방 좁혀집니다.
| 증상 | 원인과 푸는 법 |
|---|---|
스킬이 안 보임/ego-browser 를 입력해도 목록에 없음 | ① ego(lite) 첫 실행 설정(onboarding — 처음 열 때 한 번 거치는 설정)을 끝까지 마쳤는지 봅니다. ② 에이전트를 완전히 종료했다가 다시 엽니다. ③ 그래도 없으면 그 에이전트가 읽는 스킬 폴더(비교표 둘째 칸)에 ego-browser 가 있는지 확인합니다. WorkBuddy와 Hermes Agent는 복사가 필요할 수 있습니다. Claude Code는 Code 모드인지, OpenClaw는 이름이 /ego_browser 인지도 봅니다. |
| 스킬은 불러왔는데 ego(lite)가 안 열림 | 문서들은 모두 권한 설정부터 확인하라고 안내합니다. 데스크톱 앱은 그 에이전트의 권한 설정(비교표 셋째 칸)이 켜져 있는지 다시 봅니다. TUI(터미널 안에서 글자로 쓰는 화면)는 지금 세션(에이전트와 나누는 대화 한 판)을 닫고, 권한 옵션을 붙인 명령(넷째 칸)으로 새로 시작합니다. |
| 사이트가 로그인·인증을 요구함 | 고장이 아닙니다. ego(lite)의 에이전트 Space(스페이스 — 에이전트 전용 작업 공간)에 들어가 내가 직접 로그인이나 인증을 마친 뒤(넘겨받기), 에이전트에게 계속하라고 말합니다(DeepSeek Harness 문서는 작업을 다시 실행하라고 안내합니다). 비밀번호나 인증 코드를 프롬프트(에이전트에게 보내는 글)에 붙여 넣지 않습니다. 자세한 흐름은 2장. |
| TUI가 엉뚱한 폴더(프로젝트)에서 열림 | 에이전트를 끝내고, 터미널에서 맞는 프로젝트 폴더로 이동한 뒤 같은 명령을 다시 실행합니다. 명령을 실행한 현재 폴더가 그 세션의 프로젝트가 됩니다. (OpenCode · WorkBuddy의 CodeBuddy Code · Hermes Agent 문서의 안내) |
여기에 없는 문제라면 아래에서 찾습니다.
그 에이전트에만 있는 문제
권한 항목이 목록에 없음, 명령을 못 찾음, Gateway 연결 실패 같은 것은 위의 에이전트별 소절 표에 있습니다. 비교표에서 내 에이전트 이름을 누르세요.
내가 만든 에이전트 · 로컬 모델
직접 만든 에이전트 프로그램이나 내 컴퓨터에서 도는 모델을 연결하다 막혔다면 6장을 봅니다.
설치부터 다시
ego(lite) 설치와 첫 실행 설정을 처음부터 다시 확인하려면 1장을 봅니다.
- 어느 에이전트든 순서는 같습니다 — ego(lite) 첫 실행 설정 → 에이전트 완전히 다시 열기 → 권한 넓히기 → 스킬 불러오기 → 일 맡기기 → 결과 확인.
- 에이전트마다 다른 것은 스킬을 읽는 폴더, 권한 설정의 이름과 위치, 스킬을 부르는 입력 세 가지입니다. 비교표에서 내 에이전트의 줄만 보면 됩니다.
- 함정 하나씩 — Claude Code는 Code 모드, Codex는 ChatGPT 앱이면 Codex 모드, Cursor는 Run Everything, OpenCode는 스킬과 작업을 두 메시지로, WorkBuddy·Hermes Agent는 스킬 폴더 복사, Hermes Agent는 띄어쓰기, OpenClaw는
/ego_browser, DeepSeek Harness는 Web UI. - 스킬이 안 보이면 설치·재시작·폴더를, ego(lite)가 안 열리면 권한을 확인합니다.
- 사이트가 로그인을 요구하면 에이전트 Space에서 내가 직접 처리하고, 비밀번호나 인증 코드는 프롬프트에 붙여 넣지 않습니다.
출처: lite.ego.app/document/en/docs/claude-code · /codex · /cursor · /opencode · /workbuddy · /hermes-agent · /openclaw · /deepseek-harness · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
내 에이전트 · 로컬 모델 연결
5장에 나온 에이전트가 아니어도 ego(lite)를 쓸 수 있습니다. 직접 만들었거나 따로 구한 하니스(Agent Harness — AI 모델에게 도구를 쥐여 주고 돌리는 에이전트 프로그램)도, 인터넷 서비스 대신 내 컴퓨터에서 도는 로컬 모델도 연결됩니다. 조건은 하나입니다. 에이전트가 ego(lite)가 설치된 바로 그 컴퓨터에서 ego-browser 명령을 실행할 수 있으면 됩니다.
- 내 에이전트가 명령을 어디에서 실행하는지 가려내고, 그에 따라 무엇이 필요한지 아는 법
- “호스트 실행”과 “승인 생략”이 왜 서로 다른 것이고, 위험도 다른지
- 스킬을 불러오고, 단순한 공개 페이지로 연결을 시험하는 법
- Ollama와 OpenCode로 내 컴퓨터의 로컬 모델에게 브라우저 작업을 맡기는 법
시작 전 준비
하니스 종류와 상관없이 먼저 갖출 것은 같습니다. ego(lite)를 설치하고, 첫 실행 설정(onboarding)을 마치고, 하니스가 셸 명령(터미널에 입력하는 명령)을 실행할 수 있어야 합니다.
| 순서 | 할 일 | 알아 둘 것 |
|---|---|---|
| ① 설치 | DMG 파일을 내려받아 열고, 안내에 따라 ego(lite) 아이콘을 두 번 눌러 설치합니다. | 처음 설치하는 과정은 1장에 있습니다. |
| ② 첫 실행 설정 | ego(lite)를 열고 첫 실행 설정을 끝까지 마칩니다. | 이때 여러 에이전트가 함께 쓰는 ego-browser 스킬(Skill — 에이전트에게 주는 사용 설명서 묶음)이 ~/.agents/skills/ 아래에 설치됩니다. |
| ③ 완전히 껐다 켜기 | 에이전트 앱을 완전히 종료한 뒤 다시 실행합니다. | 그래야 새로 설치된 스킬을 다시 읽습니다. 지금 세션(에이전트와 이어서 주고받는 대화 한 묶음)이나 창만 닫으면 다시 읽지 않을 수 있습니다. |
| ④ 명령 실행 확인 | 하니스를 데스크톱 앱이나 TUI(터미널 안에서 글자로 쓰는 화면)로 엽니다. | ego(lite)가 설치된 컴퓨터에서 명령을 실행할 수 있는지 확인합니다. |
스킬 폴더와 슬래시 명령 — 하니스가 Agent Skills를 지원할 때
- 하니스가 Agent Skills를 지원한다면
~/.agents/skills/폴더를 살피도록 설정하거나, 그 하니스 문서에 나온 방법으로 스킬을 가져옵니다. - 스킬 슬래시 명령(대화창에
/이름으로 입력해 스킬을 부르는 기능)을 지원하는 앱은, 완전히 껐다 켠 뒤에 ego-browser에 해당하는 슬래시 명령을 보여 줍니다.
명령이 어디서 실행되나 — 세 가지 경우
하니스(에이전트를 돌리는 프로그램)가 ego(lite)를 조종하려면 ego(lite)가 설치된 컴퓨터에서 ego-browser를 실행할 수 있어야 합니다. 그래서 먼저 답할 질문은 “내 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)는 명령을 어디에서 실행하는가”입니다. 이 답이 호스트 실행(명령이 ego(lite)가 설치된 바로 그 컴퓨터에서 실행되는 것) 권한이 따로 필요한지를 정합니다.
| 명령이 실행되는 곳 | 필요한 것 | 다음에 볼 곳 |
|---|---|---|
| ① 이 컴퓨터에서 직접 샌드박스(프로그램을 가둬 두는 격리된 실행 칸) 없음 | 추가로 필요한 것이 없습니다. ego-browser가 이 컴퓨터에 설치된 ego(lite)를 바로 띄울 수 있습니다. Bypass permissions 같은 권한 넓히기 설정이 아예 없을 수 있고, 일부러 만들 필요도 없습니다. | 스킬 불러오기 |
| ② 로컬 샌드박스 안 | 하니스가 공식으로 제공하는 호스트 실행(host-execution), 샌드박스 밖 실행(unsandboxed), 호스트 브리지(host-bridge — 격리된 곳에서 내 컴퓨터로 명령을 건네주는 다리) 가운데 하나. 에이전트가 ego-browser를 이 컴퓨터로 넘겨 실행하게 해 줍니다. | 호스트 실행과 승인 생략 |
| ③ 컨테이너(프로그램을 따로 담아 돌리는 격리된 상자) · 가상 머신(컴퓨터 안에 소프트웨어로 만든 또 하나의 컴퓨터) · 원격 서버 · 클라우드 | 이 컴퓨터에서 ego-browser를 실행해 줄 호스트 브리지. 이것이 없으면, 원격 환경 안에 스킬을 설치하거나 불러오는 것만으로는 내 컴퓨터의 ego(lite) 앱을 조종할 수 없습니다. | 막힐 때 |
데스크톱 앱인지 TUI(터미널 안에서 글자로 쓰는 화면)인지는 “설정이 어디 있는지”만 가릅니다. 데스크톱 앱도 명령을 내 컴퓨터에서 직접 돌릴 수도, 샌드박스 안에서 돌릴 수도 있고, TUI도 마찬가지입니다. 화면 종류로 설정 위치를 찾은 다음, 명령이 실제로 어디서 도는지는 따로 살핍니다.
| 쓰는 화면 | 권한 설정을 찾아볼 곳 |
|---|---|
| 데스크톱 앱 (Desktop) | 세션, 작업 공간(workspace), 에이전트(Agent), 도구(Tool), 보안(security) 설정 |
| 터미널 화면 (TUI) | 시작할 때 붙이는 옵션(startup flags), 설정 파일, 환경 변수(프로그램에 넘겨주는 설정 값), 세션 상태 줄(status line) |
ego-browser가 보이는지 확인하기
브라우저 작업을 맡길 바로 그 세션에서, 에이전트에게 아래 명령을 실행해 달라고 합니다. 다른 창이나 평소 쓰는 터미널이 아니라 같은 세션이어야 의미가 있습니다.
command -v ego-browser
| 이 명령이 알려 주는 것 | 알려 주지 못하는 것 |
|---|---|
지금 세션이 ego-browser를 찾을 수 있는지 | 명령이 호스트 컴퓨터(ego(lite)가 설치된 바로 이 컴퓨터)에서 실행되는지. 이것은 하니스의 세션 정보나 공식 문서로 실행 환경을 알아낸 뒤, 실제 연결 시험으로 확인합니다. |
경로(ego-browser가 놓인 위치를 적은 한 줄)가 나오지 않으면 먼저 ego(lite)의 첫 실행 설정을 마쳤는지 봅니다. 마쳤는데도 안 나오면, 하니스가 평소 쓰는 터미널과 다른 PATH(명령을 찾을 때 컴퓨터가 뒤지는 폴더 목록)나 다른 실행 환경을 쓰고 있는지 확인합니다.
호스트 실행과 승인 생략은 다른 것
에이전트가 샌드박스 안에서 돈다면, 계속하기 전에 샌드박스 밖에서 실행할 수 있는지, 그래서 ego(lite)가 설치된 컴퓨터에서 ego-browser를 돌릴 수 있는지 확인해야 합니다. 이미 샌드박스 없이 이 컴퓨터에서 직접 돈다면 추가 권한은 필요 없습니다.
여기서 구분해야 할 두 설정이 있습니다. 둘 다 에이전트의 권한을 다루지만 하는 일이 다릅니다.
| 구분 | 호스트 실행 (샌드박스 밖 실행) | 승인 생략 (no-approval) |
|---|---|---|
| 하는 일 | 명령을 샌드박스 밖, ego(lite)가 설치된 컴퓨터에서 실행하게 합니다. | 명령을 실행하기 전마다 뜨는 확인을 없앱니다. |
| ego(lite) 연결에 | 샌드박스를 쓰는 하니스라면 필요합니다. | 필수가 아닙니다. 확인 횟수를 줄여 줄 뿐이고, 명령을 하나씩 직접 승인해도 연결됩니다. |
| 따르는 위험 | 에이전트가 내 컴퓨터에서 손댈 수 있는 범위가 넓어집니다. | 명령마다 거치던 확인 단계가 사라집니다. |
| 켜는 순서 | 샌드박스를 쓴다면 먼저 하니스 공식 문서대로 호스트 실행이나 호스트 브리지를 켭니다. | 그다음, 필요할 때만 믿을 수 있는 세션에 한해 승인 정책을 조정합니다. |
원문 영상 속 OpenClaw 예시 두 가지 — 그대로 베끼면 안 되는 이유
| 예시 | 영상이 보여 주는 것 | 읽을 때 주의 |
|---|---|---|
| 데스크톱: 승인 정책 | OpenClaw의 Exec Approvals(명령 실행 승인) 설정 화면. 데스크톱 하니스가 명령 승인을 관리하는 한 가지 모습입니다. | 승인 확인을 끈다고 에이전트에게 호스트 실행 권한이 있다는 증거가 되지 않습니다. 샌드박스를 쓰는 하니스라면 먼저 공식 문서대로 호스트 실행이나 호스트 브리지를 켜고, 그다음 필요하면 승인 정책을 바꿉니다. |
| TUI: 승인 생략 모드 | OpenClaw가 TUI를 열기 전에 자기 제품의 승인 생략 프리셋(미리 묶어 둔 설정)을 적용하는 모습. | OpenClaw의 승인 정책을 바꿀 뿐, 다른 하니스가 샌드박스를 벗어날 수 있게 됐다는 뜻이 아닙니다. 내 하니스 문서가 지원한다고 밝히지 않았다면 OpenClaw의 명령을 그대로 가져다 쓰지 마세요. 내 하니스가 제공하는 공식 호스트 실행 방법과 승인 설정을 각각 따로 찾습니다. |
ego-browser 스킬 불러오기
스킬을 불러온다는 것은 에이전트에게 ego-browser 사용 설명서를 읽히는 일입니다. 방법은 하니스 화면에 따라 다릅니다.
| 상황 | 하는 일 |
|---|---|
| 데스크톱 앱 | 내 컴퓨터에서 돌고 셸 명령을 실행할 수 있는 에이전트 세션을 엽니다. 그 앱의 스킬(Skill) 또는 도구(Tool) 화면에서 ego-browser를 불러옵니다. 영상에 나오는 OpenClaw의 스킬 고르기 화면과 명령은 그 제품 전용입니다. |
TUI — 슬래시 명령(대화창에 /이름으로 입력해 스킬을 부르는 기능)이 있을 때 | /ego-browser를 입력하고, 한 칸 띄운 뒤, 같은 메시지에 할 일을 이어서 씁니다. |
| TUI — 슬래시 명령이 없을 때 | 작업을 시작하기 전에 에이전트에게 “ego-browser 스킬을 찾아서 읽어라”라고 시킵니다. |
/ego-browser 항목이 안 보인다는 것만으로 스킬을 못 쓴다는 뜻은 아닙니다. 스킬 파일은 ~/.agents/skills/ego-browser/SKILL.md에 있고, 에이전트가 이 파일을 읽으면 됩니다.
처음 보내는 프롬프트로 아래 호환성 확인을 맡기면, 실행 위치 점검과 스킬 읽기를 한 번에 시킬 수 있습니다.
First determine whether your command runtime is running directly on this computer or inside a sandbox, container, or remote environment. If it uses a sandbox, confirm that you have an official permission or bridge that lets commands run on this computer. Do not treat disabled approval prompts as proof of host execution.
Then locate and read the ego-browser Skill. First check ~/.agents/skills/ego-browser/SKILL.md. If you cannot execute ego-browser on this computer, stop and explain what host-execution permission or bridge is missing.
- 뜻 (첫 문단): 먼저 네 명령 실행 환경이 이 컴퓨터에서 직접 도는지, 샌드박스·컨테이너·원격 환경 안에서 도는지 판단해 줘. 샌드박스를 쓴다면 명령을 이 컴퓨터에서 실행하게 해 주는 공식 권한이나 브리지가 있는지 확인해 줘. 승인 확인이 꺼져 있다는 것을 호스트 실행의 증거로 삼지 마.
- 뜻 (둘째 문단): 그다음 ego-browser 스킬을 찾아 읽어 줘. 먼저
~/.agents/skills/ego-browser/SKILL.md를 확인해. 이 컴퓨터에서 ego-browser를 실행할 수 없다면 멈추고, 어떤 호스트 실행 권한이나 브리지가 빠져 있는지 설명해 줘.
연결 시험 — example.com 열어 보기
내 에이전트가 ego(lite)를 정말 조종할 수 있는지는 직접 열어 보는 시험으로만 확정됩니다. 로그인된 사이트를 열기 전에, 누구나 볼 수 있는 단순한 페이지로 먼저 시험합니다. 에이전트에게 이렇게 보냅니다.
Use the ego-browser Skill to open https://example.com in ego (lite), report the page title, and leave the page open.
뜻: ego-browser 스킬을 써서 ego(lite)에서 example.com을 열고, 페이지 제목을 알려 준 다음, 페이지는 열어 둬.
| 보이는 결과 | 뜻 | 다음에 할 일 |
|---|---|---|
| ① ego(lite)에 에이전트 Space(스페이스 — 에이전트 전용 작업 공간)가 열리고, 페이지가 뜨고, 하니스가 페이지 제목을 돌려준다 | 호스트 실행 길이 제대로 통합니다. | 아래 “실제 작업 맡기기”로 넘어갑니다. |
| ② 내가 명령을 직접 승인한 뒤에 페이지가 열린다 | 남은 것은 승인 정책뿐입니다. | 계속 직접 승인하거나, 믿을 수 있는 세션에 한해 그 하니스 문서에 나온 승인 생략 설정을 씁니다. |
| ③ 명령이 이 컴퓨터에 끝내 닿지 않는다 | 실행 위치나 호스트 실행 쪽 문제입니다. | 실행 위치와 호스트 실행 권한·브리지를 다시 확인합니다. |
실제 작업 맡기기
연결 시험이 통하면 진짜 브라우저 작업을 줍니다. 공식 안내가 에이전트마다 똑같이 쓰는 예시 작업은 이것입니다.
Use the ego-browser Skill to open Anthropic's official X profile and collect the first five posts shown in the Posts feed.
뜻: ego-browser 스킬을 써서 Anthropic 공식 X 프로필을 열고, Posts 피드에 보이는 첫 글 다섯 개를 모아 줘.
- 하니스가 슬래시 명령을 지원하지 않아도, 에이전트가 스킬을 찾을 수 있고 호스트 컴퓨터에서
ego-browser를 실행할 수 있으면 이런 평범한 문장 지시만으로 충분합니다. - 어떤 하니스를 쓰든 ego(lite) 쪽에서 눈에 보이는 흐름은 같습니다. 에이전트가 스킬을 불러오고 → 에이전트 Space를 열고 → 대상 페이지를 방문하고 → 요청받은 정보를 모읍니다.
결과 확인하기
- 하니스가 요청한 정보를 돌려줬는지 봅니다. 답을 보여 주는 모양은 하니스마다 다를 수 있습니다.
- 원본 페이지가 ego(lite)에 열린 채 남아 있는지 봅니다. 에이전트가 무엇을 보고 답했는지 대조할 수 있습니다.
하니스 연결이 막힐 때
증상에 맞는 줄을 찾으세요. 대부분은 “명령이 어디서 실행되는가”로 돌아가면 풀립니다.
| 증상 | 왜 그런가 | 이렇게 하세요 |
|---|---|---|
| 내 하니스에 Bypass permissions 설정이 없다 | 정상일 수 있습니다. 명령이 이미 샌드박스 없이 내 컴퓨터에서 직접 돈다면, 넘어설 샌드박스 권한 자체가 없습니다. | 에이전트 세션에서 command -v ego-browser가 경로를 돌려주는지 보고, 연결 시험으로 확인합니다. 하니스가 명령마다 승인만 묻는 것이라면, 그 설정을 찾는 대신 매번 직접 승인해도 됩니다. |
/ego-browser가 나타나지 않는다 | 슬래시 명령은 하니스 화면의 기능이지, ego(lite)가 요구하는 조건이 아닙니다. | 에이전트에게 ~/.agents/skills/ego-browser/SKILL.md를 읽으라고 시킵니다. 또는 하니스가 지원하는 스킬 가져오기 방법으로 ~/.agents/skills/를 살피도록 설정합니다. |
ego-browser를 찾지 못한다 | 첫 실행 설정이 덜 끝났거나, 하니스가 다른 PATH·실행 환경을 쓰고 있을 수 있습니다. | ego(lite) 첫 실행 설정을 마치고, 하니스를 다시 시작한 뒤, 같은 에이전트 세션에서 command -v ego-browser를 다시 실행합니다. 평소 터미널에서는 되는데 하니스에서만 안 되면 둘의 PATH와 실행 환경을 비교합니다. |
| 에이전트가 계속 승인을 묻는다 | 하니스가 승인 정책을 아직 적용하고 있다는 뜻일 뿐입니다. 에이전트가 샌드박스에 갇혀 있다는 증거가 아닙니다. | 직접 승인하면 ego(lite)가 열린다면, 계속 승인하거나 믿을 수 있는 세션에 한해 그 제품 문서에 나온 승인 생략 설정을 씁니다. 승인해도 명령이 호스트에 닿지 않으면 호스트 실행 권한이나 브리지를 확인합니다. 다른 제품의 명령이나 옵션을 베껴 오지 마세요. |
| 하니스가 Docker, SSH, 클라우드에서 돈다 | 하니스가 호스트 실행 브리지를 제공하지 않는 한, 원격 실행 환경은 내 컴퓨터에 설치된 ego(lite)를 조종할 수 없습니다. | 셋 중 하나를 합니다. 하니스를 내 컴퓨터에서 돌린다 / 하니스가 지원하는 브리지를 설정한다 / 에이전트가 도는 바로 그 기계에 호환되는 브라우저 환경을 설치해 실행한다. |
| 스킬은 불러왔는데 ego(lite)가 열리지 않는다 | 스킬을 불러오면 에이전트가 사용법을 알게 될 뿐입니다. 명령이 실행되는 곳을 샌드박스나 원격 기계에서 내 컴퓨터로 옮겨 주지는 않습니다. | 에이전트가 ego(lite)가 설치된 컴퓨터에서 ego-browser를 실행하고 있는지 확인합니다. |
더 읽을 곳 — 원문이 함께 안내하는 문서
- 설치와 첫 브라우저 작업: 1장 시작하기
- 기성 에이전트 연결: Claude Code · Codex(데스크톱·TUI) · OpenCode(데스크톱·TUI) · DeepSeek Harness(로컬 웹 화면·화면 없는 터미널)
- 이 장의 영상 예시로 쓰인 화면: OpenClaw
- 브라우저 조종 명령: 4장 ego-browser · 에이전트 Space가 내 탭과 따로 있는 방식: 2장 Space
로컬 모델로 쓰기 — 무엇이 필요한가
로컬 모델(인터넷 서비스가 아니라 내 컴퓨터에서 직접 돌리는 AI 모델)로도 ego(lite)를 조종할 수 있습니다. 공식 안내는 Qwen3.8 27B 모델과 OpenCode를 예로 들고, 프로그램 세 개를 같은 Mac 한 대에 둡니다.
| 프로그램 | 맡는 일 | 준비 |
|---|---|---|
| Ollama | 로컬 모델을 내려받고 실행합니다. | 설치한 뒤 앱을 열어 설정 안내를 끝까지 마칩니다. |
| OpenCode | 모델에 연결하고 작업을 실행합니다. | OpenCode 자체의 일반적인 연결 방법은 5장 OpenCode에 있습니다. |
| ego(lite) | 브라우저 동작을 처리합니다. | DMG를 내려받아 설치하고 첫 실행 설정(onboarding)을 마칩니다(1장). |
세 프로그램을 설치했다면 모델 설정 전에 두 가지를 해 둡니다.
- OpenCode를 완전히 껐다 켜기ego(lite) 첫 실행 설정이 ego-browser 스킬을
~/.agents/skills/에 설치합니다. 실행 중인 TUI(터미널 안에서 글자로 쓰는 화면) 세션까지 포함해 OpenCode를 완전히 종료하고 다시 열어야 스킬 목록을 다시 읽습니다. 새 대화를 여는 것만으로는 완전한 재시작이 아닙니다. - Ollama가 응답하는지 보기Ollama를 켜 둔 채 터미널(글자로 명령을 입력하는 창)에서
ollama list를 실행합니다. 모델 목록이 나오면 계속합니다. 아직 모델을 받기 전이면 목록이 비어 있어도 괜찮습니다.
ollama list가 안 될 때
ollama list
ollama명령을 찾지 못한다고 나오면: Ollama의 CLI(터미널에서 쓰는 명령 도구) 설정을 마치고 터미널을 다시 엽니다.- 서비스에 연결할 수 없다고 나오면: Ollama 앱을 엽니다.
그다음 순서는 모델 설정 → OpenCode에서 모델 고르기 → 권한을 켜고 작업 맡기기입니다.
로컬 모델 설정 — 두 가지 길
직접 따라 하거나, 이미 잘 돌아가는 AI 도우미에게 맡길 수 있습니다. 어느 길이든 하는 일은 같습니다. 모델을 내려받고, 컨텍스트 길이(context length — 모델이 한 번에 붙들고 다룰 수 있는 글의 양)를 정하고, OpenCode 설정 파일을 넣습니다. 한쪽만 하면 되고, 끝나면 OpenCode에서 모델 고르기로 갑니다.
- 모델 내려받기터미널에서
ollama pull qwen3.8:27b를 실행하고 내려받기가 끝날 때까지 기다립니다. 내려받는 크기는 약 18 GB입니다. 끝나면ollama list에qwen3.8:27b가 보여야 합니다. - 컨텍스트 길이를 64k 이상으로Ollama 앱의 설정을 열어 컨텍스트 길이를 64k 이상으로 맞춥니다. Ollama의 OpenCode 연동 안내가 요구하는 시작점이 64k입니다. 컴퓨터에 남은 메모리가 충분한지 확인하세요.
- 프로젝트 폴더 만들기문서(Documents) 폴더 안에
Qwen-Setup-Guide폴더를 만들고 그 안으로 들어갑니다. 설정 파일을 여기에 둡니다. 내 프로젝트 폴더를 써도 되지만, 이후 단계에서 계속 같은 폴더를 써야 합니다. - opencode.json 넣기프로젝트 폴더 맨 위에
opencode.json파일을 만들고, 모델 이름과 Ollama 주소를 적은 설정을 붙여 넣습니다. 로컬 Ollama에 연결하는 데에는 클라우드 API 키(인터넷 AI 서비스를 쓸 때 내는 비밀 열쇠 글자)가 필요 없습니다. - 서비스와 모델 확인터미널에서 확인 명령을 실행해, 돌아온 모델 목록에
qwen3.8:27b가 있는지 봅니다. 있으면 직접 설정은 끝입니다. 길 2를 또 할 필요는 없습니다.
1단계 명령 — 모델 내려받기
ollama pull qwen3.8:27b
ollama list
Ollama의 모델 목록은 이 모델을 Q4_K_M 모델, 내려받기 약 18 GB로 표시합니다. 실행할 때는 여기에 더해 컨텍스트와 다른 앱이 쓸 메모리도 필요합니다.
2단계 — Ollama를 CLI로만 설치했을 때의 컨텍스트 길이
공식 컨텍스트 길이 안내에 따라, 서비스를 시작할 때 값을 함께 줍니다.
OLLAMA_CONTEXT_LENGTH=65536 ollama serve
- 이것은 앱을 실행하는 것의 대안입니다. 앱과 나란히 하나 더 띄우는 서비스가 아닙니다.
- 이미 돌고 있는 Ollama 서비스가 포트(프로그램이 통신에 쓰는 번호 붙은 출입구)를 차지하고 있으면 먼저 정상적으로 종료합니다.
- 이 터미널 창은 열어 두고, 이후 명령은 다른 창에서 실행합니다.
3단계 명령 — 프로젝트 폴더 만들기
mkdir -p "$HOME/Documents/Qwen-Setup-Guide"
cd "$HOME/Documents/Qwen-Setup-Guide"
pwd
4단계 — opencode.json 전문과 저장 방법
OpenCode의 프로젝트 설정 안내에 따라 opencode.json을 프로젝트 폴더 맨 위(root)에 둡니다. 폴더에 이미 opencode.json이나 opencode.jsonc가 있다면 백업하고 해당 항목만 합칩니다. 관계없는 설정은 그대로 두고, 서로 충돌하는 설정 파일을 새로 만들지 않습니다. 아래는 새 파일을 만드는 예입니다. 프로젝트 폴더에서 실행합니다.
nano opencode.json
열린 편집기에 아래 내용을 붙여 넣습니다.
{
"$schema": "https://opencode.ai/config.json",
"model": "ollama/qwen3.8:27b",
"small_model": "ollama/qwen3.8:27b",
"provider": {
"ollama": {
"npm": "@ai-sdk/openai-compatible",
"name": "Ollama",
"options": {
"baseURL": "http://localhost:11434/v1"
},
"models": {
"qwen3.8:27b": {
"name": "Qwen3.8 27B"
}
}
}
}
}
- 저장: Control + O를 누르고 Enter, 이어서 Control + X로 나옵니다.
- 파일 이름은 정확히
opencode.json이어야 합니다. 뒤에.txt가 덧붙으면 안 됩니다. - 공식 제공자(provider) 예시에서 모델만
qwen3.8:27b로 바꾼 것입니다.model은 기본 모델,small_model은 가벼운 작업에 쓰는 모델이고, 여기서는 둘 다 로컬 Qwen을 씁니다. - 저장한 설정을 글 편집기로 다시 보려면 프로젝트 폴더에서
open -t ./opencode.json을 실행합니다.
5단계 명령 — 서비스와 모델 확인
curl -fsS http://localhost:11434/v1/models
- 연결에 실패하면: Ollama가 실행 중인지 확인합니다.
- 목록에 모델이 없으면: 내려받기가 끝났는지 확인합니다.
맡길 수 있는 AI는 정상적으로 응답하고, 내 컴퓨터의 파일을 읽고 쓰며, 명령을 실행할 수 있는 에이전트입니다. 내 컴퓨터에 접근하지 못하는 대화 전용 도우미는 이 일을 대신할 수 없습니다. OpenCode로 설정을 맡긴다면, 아직 설정하지 않은 로컬 Qwen이 아니라 이미 동작하는 모델을 고릅니다.
- 폴더 열기설정을 둘 프로젝트 폴더를 AI 도우미에서 열고, 작업 폴더가 맞는지 확인합니다.
- 프롬프트 보내기아래 접힌 상자의 프롬프트를 보내고, 이 설정에 필요한 작업을 승인합니다.
- 실제 확인 결과 기다리기도우미가 Ollama 앱 설정을 바꿔 달라고 하면 내가 직접 바꿉니다. 실패한 확인이 있으면 해결한 뒤에 다음으로 넘어갑니다.
AI 도우미에게 보낼 프롬프트 전문과 뜻
Follow the official Ollama and OpenCode documentation to connect local qwen3.8:27b to OpenCode on this Mac. Check the installed OpenCode version first and use its documented configuration format rather than mixing syntax from different versions.
References:
https://docs.ollama.com/integrations/opencode
https://docs.ollama.com/context-length
https://opencode.ai/docs/providers/#ollama
https://opencode.ai/docs/config/
Ollama, OpenCode, and ego (lite) are installed. Complete these steps:
1. Confirm the absolute path of the current project folder. Before editing, inspect and back up any existing opencode.json or opencode.jsonc. Preserve unrelated settings, do not create conflicting configuration files, and do not change global OpenCode configuration.
2. Check the Ollama service and ollama list. If qwen3.8:27b is missing, explain the approximately 18 GB download and storage requirements, then get my confirmation before running ollama pull qwen3.8:27b. Do not create a recording-specific alias or Modelfile.
3. Set at least 64k context using the official instructions. For the Ollama application, guide me through its settings. For a CLI-only installation, you may start OLLAMA_CONTEXT_LENGTH=65536 ollama serve after I confirm. Do not terminate an existing service without permission or start a conflicting second service.
4. Use the official Ollama provider format in the project: provider ID ollama, npm @ai-sdk/openai-compatible, name Ollama, options.baseURL http://localhost:11434/v1, and model qwen3.8:27b with name Qwen3.8 27B. Set model and small_model to ollama/qwen3.8:27b. Do not add cloud API keys, custom sampling parameters, reasoning toggles, or output limits.
5. Validate the configuration syntax and check that http://localhost:11434/v1/models includes qwen3.8:27b. If the OpenCode CLI is available, run opencode models ollama from the project folder and check that it recognizes ollama/qwen3.8:27b. If an existing provider restriction prevents loading, explain the conflict and ask me before changing it.
6. Report the changed file paths, actual check results, remaining actions for me, and the folder I should open in OpenCode. If the model has not loaded, do not claim its runtime context has been verified; explain how to check it with ollama ps once it runs. Do not submit a browser task for me.
뜻: Ollama와 OpenCode 공식 문서를 따라 이 Mac에서 로컬 qwen3.8:27b를 OpenCode에 연결해 줘. 먼저 설치된 OpenCode 버전을 확인하고, 여러 버전의 문법을 섞지 말고 그 버전 문서에 나온 설정 형식을 써 줘. (참고 문서 주소 네 개) Ollama, OpenCode, ego(lite)는 설치되어 있어. 다음 단계를 끝내 줘.
- 현재 프로젝트 폴더의 절대 경로를 확인한다. 고치기 전에 기존 opencode.json·opencode.jsonc가 있으면 살펴보고 백업한다. 관계없는 설정은 그대로 두고, 충돌하는 설정 파일을 만들지 않으며, OpenCode 전역 설정은 바꾸지 않는다.
- Ollama 서비스와 ollama list를 확인한다. qwen3.8:27b가 없으면 약 18 GB 내려받기와 저장 공간이 필요하다고 설명하고, 내 확인을 받은 뒤에 내려받는다. 녹화용 별칭이나 Modelfile은 만들지 않는다.
- 공식 안내대로 컨텍스트를 64k 이상으로 맞춘다. Ollama 앱이면 설정 화면을 안내하고, CLI만 설치했다면 내 확인을 받은 뒤 값을 주어 서비스를 시작해도 된다. 허락 없이 기존 서비스를 끝내거나, 충돌하는 두 번째 서비스를 띄우지 않는다.
- 프로젝트에 공식 Ollama 제공자 형식을 쓴다(제공자 ID, npm 패키지, 이름, 로컬 주소, 모델과 표시 이름은 원문에 적힌 값 그대로). model과 small_model은 ollama/qwen3.8:27b로 둔다. 클라우드 API 키, 사용자 지정 샘플링 값, 추론(reasoning) 스위치, 출력 제한은 넣지 않는다.
- 설정 문법을 검증하고, 로컬 주소의 모델 목록에 qwen3.8:27b가 있는지 확인한다. OpenCode CLI를 쓸 수 있으면 프로젝트 폴더에서 opencode models ollama를 실행해 모델을 알아보는지 확인한다. 기존 제공자 제한 때문에 불러오지 못하면 충돌을 설명하고, 바꾸기 전에 나에게 묻는다.
- 바뀐 파일 경로, 실제 확인 결과, 내가 마저 할 일, OpenCode에서 열 폴더를 보고한다. 모델이 아직 올라오지 않았다면 실행 중 컨텍스트를 확인했다고 말하지 말고, 모델이 돌 때 ollama ps로 확인하는 법을 설명한다. 브라우저 작업을 나 대신 보내지 않는다.
OpenCode에서 로컬 모델 고르기
어느 길로 설정했든, 이제 OpenCode가 그 설정을 읽게 합니다. 핵심은 설정 파일 하나가 아니라 그 파일이 든 폴더 전체를 여는 것입니다.
📁 Qwen-Setup-Guide ← 이 폴더 전체를 엽니다
└ 📄 opencode.json ← 이 파일만 고르지 않습니다
- 저장 확인 후 다시 시작설정이 저장됐는지 확인합니다. OpenCode가 이미 켜져 있으면 완전히 종료하고 다시 시작합니다.
- 폴더 전체 열기 (데스크톱 앱)OpenCode Desktop의 프로젝트 열기 기능으로
opencode.json이 든 폴더 전체를 고릅니다. 예를 들어 문서 폴더의Qwen-Setup-Guide를 고릅니다. - 모델 고르기대화 입력 칸 아래의 모델 메뉴를 눌러 Ollama 아래에 있는 Qwen3.8 27B를 고릅니다. 설정 파일에 적어 둔 표시 이름입니다.
- TUI라면터미널에서 같은 프로젝트 폴더로 들어간 뒤, 다음 소절 1단계의 시작 명령을 실행합니다.
컨텍스트가 실제로 64k인지 확인하기 — ollama ps
모델이 돌기 시작하면 다른 터미널 창에서 ollama ps를 실행해 CONTEXT 값이 64k에 이르는지 봅니다. 목록에 모델이 없으면 아직 올라오지 않았거나 이미 내려간 것이고, 그 출력으로는 실행 중 컨텍스트를 확인할 수 없습니다.
TUI만 쓴다면 — Ollama의 빠른 실행 명령과 그 한계
ollama launch opencode --model qwen3.8:27b
Ollama가 공식으로 제공하는 빠른 실행입니다. 다만 이 명령은 그때 실행된 프로그램에만 설정을 건네줍니다. 데스크톱 앱이 쓸 프로젝트 설정이 저장됐다는 뜻이 아닙니다. 이 안내가 프로젝트 설정 파일을 두는 이유는 데스크톱 앱과 TUI가 같은 프로젝트를 함께 쓸 수 있게 하기 위해서입니다.
권한을 켜고 작업 맡기기
이제 순서는 다른 에이전트와 같습니다. 권한을 켜고, 스킬을 불러오고, 일을 맡기고, 결과를 확인합니다.
① 자동 승인 켜기
| 화면 | 하는 일 |
|---|---|
| 데스크톱 앱 | Settings → General(설정 → 일반)을 열어 Auto-accept permissions(권한 요청 자동 수락)를 켭니다. |
| TUI | 프로젝트 폴더에서, 로컬 모델을 지정하고 자동 승인을 켠 채로 OpenCode를 시작합니다(아래 명령). |
opencode --auto --model ollama/qwen3.8:27b
② ego-browser 스킬 불러오기
| 화면 | 하는 일 |
|---|---|
| 데스크톱 앱 | 새 세션을 시작하고 /ego-browser를 입력해 목록에서 ego-browser를 고릅니다. 스킬을 따로 한 메시지로 먼저 보내고, 그다음에 브라우저 작업을 보냅니다. |
| TUI | 로컬 Qwen3.8 27B 모델을 고르고, 아래 프롬프트를 입력 칸에 붙여 넣어 보냅니다. 프롬프트가 ego-browser를 지목하고 있으므로 슬래시 명령을 먼저 입력할 필요가 없습니다. |
Use ego-browser to collect the first five posts from Anthropic's official X profile.
뜻: ego-browser를 써서 Anthropic 공식 X 프로필의 첫 글 다섯 개를 모아 줘.
확인: OpenCode가 브라우저 명령을 시작하기 전에 스킬을 불러오는지 봅니다. 스킬을 찾지 못하면 ego(lite) 첫 실행 설정을 마치고 OpenCode를 완전히 다시 시작합니다.
③ 로컬 모델이 일하게 두기
- 작업을 OpenCode에 보냅니다. 에이전트가 ego-browser로 ego(lite)에서 Anthropic의 X 프로필을 열고, 요청받은 글을 읽고, 결과를 OpenCode 대화에 정리합니다.
- 데스크톱 앱과 TUI의 과정은 같습니다. 작업을 보낸 뒤 남은 브라우저 동작은 에이전트가 ego(lite)를 통해 처리합니다.
④ 진행을 살피고 결과 확인하기
- 작업이 끝나면 OpenCode가 글 다섯 개를 돌려줍니다. 화면에 보이는 세부 내용, 글로 바로 가는 링크, 글마다 짧은 요약이 함께 옵니다.
- Anthropic의 X 프로필은 ego(lite)에 열린 채로 남습니다. 여기까지 되면 브라우저 작업이 끝난 것입니다.
로컬 모델에서 막힐 때
| 증상 | 확인할 것 |
|---|---|
| 로컬 모델이 목록에 안 보이거나 연결되지 않는다 | Ollama가 실행 중인지, ollama list에 qwen3.8:27b가 있는지 봅니다. opencode.json이 든 프로젝트를 열었는지, 설정에 적힌 로컬 주소가 맞는지 확인합니다. 설정을 바꿨다면 OpenCode를 완전히 다시 시작합니다. |
| 모델은 대답하는데 브라우저가 움직이지 않는다 (글만 쓴다) | OpenCode가 ego-browser를 불러왔는지, 그리고 모델이 동작을 말로 설명만 하는 것이 아니라 실제로 도구 호출(tool calling)을 내고 있는지 확인합니다. 자동 승인 설정과 내 컴퓨터에서 명령을 실행할 권한도 봅니다. 글이 만들어진다는 것만으로는 브라우저를 조종하고 있다는 증거가 되지 않습니다. |
| 작업이 느리거나 중간에 멈춘다 | 로컬 모델의 생성 속도는 하드웨어, 남은 메모리, 컨텍스트 길이에 달려 있습니다. 메모리를 많이 쓰는 불필요한 앱을 닫고, “글 하나만 읽기”처럼 더 작은 작업으로 시도합니다. OpenCode가 오류를 내거나 응답을 멈췄다면, 다시 시도하기 전에 그 메시지부터 살펴봅니다. |
더 읽을 곳 — 원문이 함께 안내하는 문서
- OpenCode의 일반적인 데스크톱·TUI 사용 흐름: 5장 OpenCode
- 내 컴퓨터에서 실행하는 것과 승인을 건너뛰는 것의 구분: 호스트 실행과 승인 생략
- 브라우저 조종 명령: 4장 ego-browser
- OpenCode 공식 문서의 providers(Ollama 제공자 설정) 항목과 permissions(자동 승인 동작과 명시적 거부 규칙) 항목
- 어떤 하니스든 조건은 하나입니다. 에이전트가 ego(lite)가 설치된 컴퓨터에서
ego-browser를 실행할 수 있어야 합니다. - 명령이 이 컴퓨터에서 직접 돌면 추가 권한이 필요 없고, 샌드박스 안이면 하니스의 공식 통로가, 컨테이너·원격 환경이면 호스트 브리지가 필요합니다. 데스크톱 앱인지 TUI인지는 설정 위치만 가릅니다.
- 호스트 실행(어디서 실행하나)과 승인 생략(실행 전에 묻나)은 다른 설정이고 위험도 다릅니다. 승인 생략은 연결의 필수 조건이 아닙니다.
command -v ego-browser는 “찾을 수 있는지”만 알려 줍니다. 연결은 example.com을 열어 제목을 받아 보는 시험으로 확정합니다.- 로컬 모델은 Ollama(모델 실행) · OpenCode(작업 진행) · ego(lite)(브라우저 동작)를 같은 Mac에 두고, 컨텍스트 길이를 64k 이상으로 맞춘 뒤
opencode.json이 든 폴더 전체를 엽니다. - 모델이 글만 쓰고 브라우저가 안 움직이면, 스킬을 불러왔는지와 실제로 도구 호출이 나가는지부터 확인합니다.
출처: lite.ego.app/document/en/docs/custom-agent-harness · lite.ego.app/document/en/docs/qwen-local · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
다른 도구와 비교 · 개인정보 · 활용 사례
AI 에이전트가 브라우저를 쓰게 해 주는 도구는 ego(lite) 말고도 많습니다. 이 장에서는 그 도구들을 다섯 유형으로 나눠 ego(lite)와 무엇이 다른지 살피고, 내 데이터가 어디에 남는지, 값은 얼마인지, 실제로 어떤 일을 맡길 수 있는지를 정리합니다. 비교 내용은 모두 ego(lite)를 만든 Citro Labs의 문서에서 온 것이므로, “만든 쪽의 설명”이라는 점을 염두에 두고 읽으세요.
- 에이전트가 브라우저를 쓰는 다섯 가지 방식과, 각 방식이 잘 맞는 경우
- 유형별로 ego(lite)가 낫다고 문서가 말하는 점과, ego(lite)도 하지 않는 것
- 기능 비교표 11행과 Real-World Bench 수치(속도·성공률·비용)
- 내 데이터 중 무엇이 내 컴퓨터에 남고 무엇이 AI 모델로 가는지
- 지원 환경과 가격, 분야별 활용 사례, 자주 묻는 질문
다섯 가지 유형 한눈에 보기 → 내 데이터는 어디에 남나 → 무엇을 맡길 수 있나 순서로 읽으면 충분합니다. 유형별 세부 비교와 측정 수치는 도구를 고를 때 돌아와서 보세요.
다섯 가지 유형 한눈에 보기
AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램 — Claude Code, Codex, Cursor 등)가 브라우저를 쓰게 해 주는 도구는 대부분 다섯 유형 가운데 하나입니다. 유형마다 브라우저가 어디에서 도는지, 누가 그 브라우저를 조종하는지가 다릅니다. ego(lite)는 내 컴퓨터에서 도는 완전한 브라우저이고, 에이전트는 그 안의 Space(스페이스 — 에이전트 전용 작업 공간)에서 일합니다.
| 유형 | 어떻게 동작하나 | 이런 때 잘 맞습니다 | ego(lite)가 낫다고 하는 점 |
|---|---|---|---|
| ① 브라우저 확장 프로그램(브라우저에 기능을 더하는 작은 프로그램) | 확장 프로그램이 에이전트를 내가 쓰고 있는 Chrome 창에 연결합니다. | 지금 보고 있는 페이지에서 받는 간단한 도움(양식 하나 채우기 등) | ego(lite)가 곧 브라우저라서, 에이전트와 브라우저를 따로 짝지어 연결할 것이 없습니다. 에이전트는 내 탭이 아니라 자기 Space에서 일합니다. |
| ② 클라우드 브라우저 | 브라우저가 서비스 업체의 서버에서 돕니다. | 브라우저를 100개 이상 한꺼번에 돌리는 제품, 내 컴퓨터가 꺼져도 계속 돌아야 하는 작업 | 내 컴퓨터에서 돕니다. 로그인 정보가 내 기기에 남고, 브라우저 사용 시간 요금이 없습니다. |
| ③ 에이전트 내장 브라우저 | AI 앱 하나 안에 들어 있는 브라우저 칸입니다. | 설정 없이 바로 쓰고 싶을 때, 에이전트를 내 실제 계정과 떼어 놓고 싶을 때 | 내 로그인이 들어 있는 완전한 Chromium(Chrome의 바탕이 되는 브라우저 엔진) 브라우저이고, 어떤 에이전트든 쓸 수 있습니다. |
| ④ 브라우저 CLI(글자로 명령을 입력해 브라우저를 조종하는 도구) | 에이전트가 보통 로그인 없이 시작하는 브라우저를 한 단계씩 조종합니다. | 실행할 때마다 새 브라우저가 필요한 경우(스크립트(정해 둔 순서대로 자동 실행하는 명령 묶음), 자동 검사) | 에이전트가 내 로그인 상태에서 시작하고, 한 번 호출할 때 여러 동작을 실행합니다. |
| ⑤ AI 브라우저 | 브라우저 회사가 만든 AI 비서가 옆 칸(사이드바)에 들어 있는 브라우저입니다. | 읽고 있는 페이지의 요약·번역 같은 빠른 도움 | 내 에이전트가 ego(lite)를 조종하므로, 내 컴퓨터의 코드와 파일도 함께 다룰 수 있습니다. |
문서가 따로 둔 제품별 세부 비교 쪽
제품 소개 문서는 유형별 설명 끝에 제품별 비교 쪽을 안내합니다: ego(lite) vs Claude in Chrome · vs Codex Chrome extension · vs Kimi Chrome extension · vs Browserbase · vs Codex browser · vs Browser Harness · vs agent-browser · vs Playwright · vs Playwright MCP · vs Puppeteer. 이 가이드는 그 쪽들을 받지 않았으므로(부록) 아래 내용은 제품 소개 문서와 첫 화면에 적힌 범위까지만 다룹니다.
브라우저 확장 프로그램과 비교
예: Claude in Chrome · Codex Chrome 확장 프로그램 · Kimi Chrome 확장 프로그램
어떻게 동작하나. 에이전트가 내 Chrome에 설치된 확장 프로그램(브라우저에 기능을 더하는 작은 프로그램)으로 명령을 보내면, 확장 프로그램이 그 명령을 내 Chrome 창에서 실행합니다. 이런 때 좋습니다. 지금 보고 있는 페이지에서 양식 하나를 채우는 것 같은 빠른 도움에는 잘 맞습니다.
반면 내가 다른 일을 계속하는 동안 돌아가는 여러 단계 작업에서는 ego(lite)가 다음 세 가지에서 낫다고 문서는 설명합니다.
설치하고 짝짓고 연결을 지킬 것이 없다
확장 프로그램 방식에서는 짝짓기(pairing — 확장 프로그램과 에이전트를 서로 연결해 두는 일)가 실패하거나, 작업 도중 연결이 끊기거나, 권한을 묻는 창이 뜨거나, 다른 확장 프로그램과 충돌할 수 있습니다. ego(lite)는 브라우저 자체라서 이런 단계가 아예 없습니다.
에이전트가 내 탭을 쓰지 않는다
확장 프로그램은 나와 같은 창에서 일하므로, 에이전트가 내가 보던 탭을 쓰거나 창의 초점(지금 키보드 입력을 받는 자리)을 가져갈 수 있습니다. ego(lite)에서는 작업마다 자기 탭을 가진 Space에서 돕니다. 마우스, 키보드 초점, 알림, 보고 있던 탭은 내 것으로 남습니다.
내가 쓰는 동안 여러 작업이 돈다
작업마다 Space가 따로 생기므로 에이전트가 여러 작업을 동시에 할 수 있습니다. 나는 어느 Space든 열어서 지켜보거나, 작업을 잠시 멈추거나, 직접 넘겨받을 수 있습니다. → 2장 Space
클라우드 브라우저와 비교
예: Browserbase
어떻게 동작하나. 브라우저가 서비스 업체의 서버에서 돌고, 내 에이전트는 인터넷을 거쳐 그 브라우저에 접속합니다. 이런 때 좋습니다. 서버에서 브라우저를 아주 많이(예를 들어 100개 이상 동시에) 돌려야 하는 제품이나, 내 컴퓨터가 꺼져 있어도 계속 돌아야 하는 작업에 맞습니다.
내 계정으로 하는 일을 내 컴퓨터에서 돌릴 때는 ego(lite)가 다음에서 낫다고 문서는 말합니다.
로그인 정보가 내 컴퓨터에 남는다
클라우드 브라우저에서 내 계정을 쓰려면 비밀번호나 쿠키(로그인했다는 것을 기억하는 정보), 로그인된 세션 저장본을 업체에 넘겨야 합니다. ego(lite)는 내 컴퓨터에서 돌기 때문에 비밀번호·쿠키·로그인 세션·Chrome에서 가져온 데이터가 호스팅 서비스로 가지 않고 내 기기에 남습니다.
브라우저 사용 시간 요금이 없다
클라우드 브라우저는 보통 세션(브라우저를 한 번 띄워 쓰는 동안)당 또는 분당으로 요금을 받습니다. ego(lite) 앱은 무료입니다. 다만 AI 모델 비용과 네트워크 비용은 그대로 듭니다.
낯선 접속 주소 때문에 뜨는 CAPTCHA가 적다
클라우드 브라우저는 업체의 IP 주소(인터넷에서 접속 위치를 나타내는 번호)로 접속합니다. 이 주소는 다른 고객과 함께 쓰고 나와 다른 나라에 있을 수도 있어서, 일부 사이트가 CAPTCHA(사람인지 확인하는 그림·퍼즐 검사)나 보안 확인을 더 자주 띄웁니다. ego(lite)는 내 인터넷 연결을 쓰고 내 VPN·프록시(인터넷 접속 경로를 바꿔 주는 설정) 설정을 따르므로, 사이트는 내가 직접 볼 때와 같은 종류의 접속으로 봅니다.
에이전트 내장 브라우저와 비교
예: Codex 브라우저 · Cursor에 내장된 브라우저
어떻게 동작하나. 일부 AI 앱에는 자체 브라우저가 들어 있습니다. 보통 앱 안의 칸으로 열리고, 그 앱의 에이전트만 쓸 수 있습니다. 이런 때 좋습니다. 따로 설정할 것이 없고, 로그인 상태가 분리되어 있어 에이전트를 내 실제 계정에서 떼어 놓을 수 있습니다.
에이전트가 내가 평소 쓰는 브라우저에서 내 실제 계정으로 일하게 하고 싶을 때는 ego(lite)가 다음 네 가지에서 낫다고 합니다.
로그인이 이미 들어 있다
내장 브라우저는 로그인 상태가 따로인 경우가 많아, 그 안에서 사이트마다 다시 로그인해야 합니다. ego(lite)는 첫 실행 설정(onboarding) 때 Chrome 프로필을 클릭 한 번으로 가져올 수 있습니다 — 탭, 북마크, 비밀번호, 확장 프로그램, 쿠키, 로그인 세션, 프로필까지입니다. → 1장
완전한 브라우저다
내장 브라우저는 일반 브라우저보다 기능이 적습니다. ego(lite)는 탭, 탭 그룹, 창, 프로필, 북마크, 저장된 비밀번호, 확장 프로그램, 다운로드, 시크릿 모드를 갖춘 완전한 Chromium 브라우저입니다. 평소 브라우저로 쓰면서 같은 브라우저 안에서 에이전트가 일하게 할 수 있습니다.
여러 작업이 동시에 돈다
내장 브라우저는 동시에 돌릴 수 있는 작업 수에 제한을 둘 수 있습니다. ego(lite)에서는 작업마다 Space가 따로이고, 여러 Space가 동시에 돕니다.
어떤 에이전트와도 쓴다
내장 브라우저는 그 앱 안에서만 동작합니다. Claude Code, Codex, Cursor, Gemini CLI, OpenClaw를 비롯한 에이전트는 모두 ego-browser(에이전트가 ego(lite)를 조종할 때 쓰는 명령 도구)를 거쳐 ego(lite)를 씁니다. 에이전트를 바꿔도 브라우저는 바꿀 필요가 없습니다. → 5장
브라우저 CLI와 비교
예: playwright-cli · Browser Harness · agent-browser · chrome-devtools-cli
어떻게 동작하나. 브라우저 CLI(Command-Line Interface — 글자로 명령을 입력해 쓰는 도구)는 에이전트가 실행해서 브라우저를 조종하는 명령줄 도구입니다. 대부분 Playwright나 Puppeteer 같은 브라우저 자동화 프레임워크(브라우저를 자동으로 움직이는 프로그램을 만들 때 쓰는 도구 묶음), 또는 Chrome DevTools Protocol(Chrome을 바깥에서 조종하는 통신 규약. 줄여서 CDP) 위에 만들어졌습니다. 이런 때 좋습니다. 스크립트나 CI(코드가 바뀔 때마다 자동으로 돌리는 검사)처럼 실행할 때마다 깨끗한 새 브라우저가 필요한 경우에 잘 맞습니다.
에이전트가 실제 웹사이트에서 일할 때는 ego(lite)가 다음 세 가지에서 낫다고 문서는 말합니다.
로그인된 채로 시작한다
이 도구들은 기본으로 빈 프로필에 로그인이 하나도 없는 브라우저를 띄웁니다. 로그인이 필요한 사이트에서는 로그인 과정을 스크립트로 짜거나 저장해 둔 쿠키를 불러와야 합니다. ego(lite)에서는 내가 로그인해 둔 사이트를 에이전트가 이미 로그인된 상태로 엽니다. 그래서 작업 중에 2FA(2단계 인증) 요청이나 SSO(회사 계정 하나로 여러 서비스에 로그인하는 방식) 이동이 줄 수 있습니다.
작업 전체의 모델 턴이 줄어든다
이 도구들에서는 에이전트가 명령(또는 작은 동작 묶음)을 보내고, 결과를 기다리고, 페이지를 다시 읽고, 다음 단계를 정합니다. 단계마다 모델 턴(AI 모델이 한 번 생각하고 답하는 차례)이 하나씩 듭니다. ego(lite)에서는 페이지 열기·읽기·누르기·양식 채우기·결과 보고를 한 번의 호출로 실행할 수 있습니다. 짧은 스냅샷(Snapshot — 에이전트가 읽는 페이지의 글 버전)과 합쳐져 작업이 더 빨리 끝나고 토큰(AI가 읽고 쓰는 글의 양을 세는 단위)도 덜 씁니다. → 4장
에이전트가 하는 일을 볼 수 있다
이 도구들은 흔히 브라우저를 헤드리스(화면에 창을 띄우지 않는 방식)로 돌립니다. ego(lite)에서는 언제든 에이전트의 Space를 열어 지켜보거나, 작업을 멈추거나, QR 코드 로그인처럼 내가 필요한 단계를 넘겨받을 수 있습니다.
문서는 이 유형의 도구 네 가지와 ego(lite)를 같은 작업으로 견준 측정도 내놓았습니다. 수치는 Real-World Bench에서 봅니다. Playwright·Puppeteer·Browser Use·agent-browser와의 차이를 묻는 질문은 자주 묻는 질문에 정리했습니다.
AI 브라우저와 비교
예: Perplexity Comet · Dia
어떻게 동작하나. AI 브라우저는 브라우저 회사가 만든 AI 비서가 옆 칸(사이드바)에 들어 있는 브라우저입니다. 비서는 그 회사의 AI 서비스에서 돌고, 브라우저 안에서만 일합니다. 이런 때 좋습니다. 읽고 있는 페이지를 요약하거나 번역하는 것 같은 빠른 도움에 잘 맞습니다.
에이전트에게 여러 웹사이트와 내 컴퓨터를 넘나드는 실제 작업을 맡기려면 ego(lite)가 낫다고 문서는 말합니다. 대표 예가 내가 만들고 있는 웹 앱의 화면을 점검하고 고치는 일입니다.
내 컴퓨터도 함께 다룬다
AI 브라우저의 비서는 보통 내 컴퓨터의 파일을 읽거나, 명령을 실행하거나, 코드 저장소(프로그램 코드를 모아 둔 곳)를 열지 못합니다. ego(lite)에서는 에이전트가 내 에이전트이므로 위 그림처럼 브라우저와 컴퓨터를 한 작업에서 씁니다.
규칙은 내가 고른 에이전트가 정한다
AI 브라우저의 비서는 그 회사가 정한 안전 규칙을 따르는데, 이 규칙이 더 엄격한 경우가 많습니다. 예를 들어 여러 페이지에서 데이터를 모으는 작업을 거절할 수 있습니다. ego(lite)는 에이전트가 어떤 작업을 해도 되는지 정하지 않습니다. 그것은 내가 고른 에이전트와 내가 정해 준 한계에 달려 있습니다.
어떤 모델이 내 페이지를 읽을지 내가 고른다
AI 브라우저의 비서는 다루는 페이지를 그 회사의 AI 서비스로 보냅니다. ego(lite)에서는 페이지 내용이 내 에이전트가 쓰는 모델로 갑니다. 그 모델은 내가 고르며, 내 컴퓨터에서 도는 로컬 모델일 수도 있습니다. → 6장
에이전트 기능에 유료 요금제가 없다
AI 브라우저는 요금제에 따라 에이전트 기능을 제한하는 경우가 많고, 뒤에서 돌리기나 여러 작업 동시 실행에는 더 높은 요금제가 필요할 수 있습니다. ego(lite) 앱은 무료이고 작업마다 Space가 따로라 여러 작업을 동시에 돌립니다. 에이전트와 모델 비용은 지금처럼 내가 냅니다.
기능 비교표 — 첫 화면의 11행
ego(lite) 사이트 첫 화면에는 “브라우저 사이를 오가지 마세요(Stop bouncing between browsers)”라는 제목 아래 기능 비교표가 있습니다. 원문 그대로 옮기면 아래와 같습니다. ✓는 지원, —는 지원하지 않음입니다. 이 표는 ego(lite)를 만든 회사가 스스로 만든 비교이고, 유형마다 예시 제품 두 개를 묶어 한 칸으로 나타낸 것입니다.
| 기능 | ego(lite) | 확장 프로그램Claude/Codex in Chrome | 내장 브라우저Claude/ChatGPT 내장 브라우저 | 클라우드 브라우저Browserbase/Browser Use | 브라우저 CLIplaywright-cli/Browser Harness | AI 브라우저Comet/Dia |
|---|---|---|---|---|---|---|
| 어떤 AI 에이전트와도 쓸 수 있음 | ✓ | — | — | ✓ | ✓ | — |
| 내 브라우저의 로그인을 씀 | ✓ | ✓ | — | — | — | ✓ |
| CAPTCHA가 덜 뜸 | ✓ | ✓ | — | — | — | ✓ |
| 내 컴퓨터 전체에 걸쳐 일함 | ✓ | — | ✓ | — | ✓ | — |
| 내 브라우저를 빼앗지 않음 | ✓ | — | ✓ | ✓ | — | — |
| 여러 작업을 동시에 실행 | ✓ | — | — | ✓ | — | — |
| 대량 수집 작업 실행 | ✓ | — | — | ✓ | ✓ | — |
| 평소 쓰는 브라우저로 쓸 수 있음 | ✓ | ✓ | — | — | — | ✓ |
| 무료 | ✓ | — | — | — | ✓ | — |
| 데이터를 내 컴퓨터에 저장 | ✓ | ✓ | ✓ | — | ✓ | — |
| 다시 쓸 수 있는 스킬 곧 제공 예정 | ✓ | — | — | — | — | — |
Real-World Bench — 속도 · 성공률 · 비용
Real-World Bench는 ego(lite)를 만든 회사가 직접 한 측정입니다. ego(lite)와 브라우저 CLI 네 가지(playwright-cli, Browser Harness, agent-browser, chrome-devtools-cli)에게 실제 운영 중인 웹사이트에서 하는 작업 31개를 똑같이 시키고, 같은 AI 모델과 같은 채점 방식으로 견주었다고 합니다. 결과는 세 가지 숫자로 나옵니다. 탭을 눌러 하나씩 보세요.
| 도구 | 작업당 평균 시간 | 완전 성공률 | 작업당 평균 비용 |
|---|---|---|---|
| ego-browser (ego(lite)) | 398초 | 93.5% | $1.64 |
| browser-harness | 615초 | 77.4% | $2.43 |
| playwright-cli | 648초 | 71.0% | $3.42 |
| agent-browser | 605초 | 62.9% | $2.66 |
| chrome-devtools-cli | 587초 | 61.3% | $4.95 |
“47~63% 빠르다”와 초 단위 숫자의 관계
원문은 계산식을 밝히지 않았습니다. 이 가이드가 위 숫자로 확인해 보면, 다른 네 도구의 평균 시간(587~648초)은 ego-browser(398초)보다 약 47~63% 깁니다(587÷398≈1.47, 648÷398≈1.63). 원문은 첫 화면에서는 측정 대상을 ego-browser로, 제품 소개 문서에서는 ego(lite)로 부릅니다.
개인정보 — 무엇이 내 컴퓨터에 남고 무엇이 나가나
ego(lite)는 내 컴퓨터에서 도는 프로그램입니다. 그래서 브라우저에 든 내 데이터는 Chrome을 쓸 때와 같은 방식으로 내 컴퓨터에 저장됩니다. 한편 AI 에이전트(내 대신 명령을 실행하며 일하는 AI 프로그램)가 어떤 페이지에서 일하면, 그 페이지의 내용은 에이전트가 쓰는 AI 모델로 전달됩니다. 이 둘을 구분해서 아는 것이 핵심입니다.
| 무엇 | 어디에 있나 · 어디로 가나 |
|---|---|
| Chrome에서 가져온 비밀번호 · 쿠키(로그인했다는 것을 기억하는 정보) · 방문 기록 · 북마크 · 확장 프로그램 · 프로필 | 내 컴퓨터에 저장됩니다. Chrome에서와 같은 방식이고 내가 통제합니다. 무엇을 남길지 내가 정하고, 설정에서 관리하거나 지울 수 있습니다. |
| 에이전트가 작업한 페이지의 내용 | 에이전트가 읽어서 자기가 쓰는 AI 모델로 보냅니다. 어떤 모델을 쓸지는 내가 고릅니다. |
| 명령과 결과 | ego(lite)가 브라우저를 돌리면서 브라우저와 내 에이전트 사이에서 전달합니다. |
| 계정 · 이메일 주소 | ego(lite)를 쓰는 데 필요 없습니다. |
데이터 처리에 관한 더 자세한 내용은 원문이 Privacy Policy(개인정보 처리방침)를 보라고 안내합니다. 이 가이드는 그 문서를 받지 않았으므로 여기 적힌 것 이상은 설명하지 않습니다.
지원 환경과 가격
| 항목 | 내용 |
|---|---|
| ego(lite) 앱 | 무료로 내려받아 씁니다. 구독이 없고, 작업당 요금도, 브라우저 사용 시간 요금도 없습니다. |
| 내가 내는 것 | 내가 쓰는 에이전트와 AI 모델 비용은 지금처럼 내가 냅니다. 클라우드 브라우저와 견준 대목에서는 모델 비용과 네트워크 비용이 그대로 든다고 적었습니다. |
| 지원 환경 | macOS 정식 · Windows 베타 · Linux 예정 |
| 계정 | 계정이나 이메일 주소 없이 씁니다. |
활용 사례 — 무엇을 맡길 수 있나
문서가 드는 사례는 크게 두 갈래입니다. 자료를 찾아 모으고 계산하는 일과, 양식을 채우거나 로그인해야 보이는 화면을 다루는 일입니다. 지원서 제출이나 결제 같은 마지막 단계가 있는 사례에서는 에이전트가 그 앞에서 멈추고 내가 검토합니다.
활용 사례 쪽의 8가지와 빠른 시작 문서의 6개 분야를 겹치지 않게 분야별로 묶었습니다. 먼저 자료를 찾아 모으고 계산하는 쪽입니다.
글 모으고 반응 살피기
내 로그인으로 어떤 계정의 최근 7일 치 본문 글을 모아(고정 글·재게시·답글은 제외) 조회 수와 반응 순으로 순위표를 만들고 계정 평균도 냅니다.
그 밖에 답글 달기, 내 메모를 넣은 인용 글, 글 초안을 써서 예약 대기에 올리기, 반응 데이터 모으기, 언급 살피기, 계정 활동 가져오기. X, LinkedIn, Threads, Reddit, Instagram, Facebook을 지원한다고 합니다. 로그인은 필요한데 API(프로그램끼리 데이터를 주고받는 창구)로는 닿지 않는 데이터가 대상입니다.
일자리 찾고 지원서 채우기
직무·지역·근무 형태로 구인 사이트를 검색하고, 회사 채용 페이지를 열어 이력서 PDF로 지원서 전체를 채웁니다. 제출 한 번의 클릭 앞에서 멈춰 내가 검토하게 합니다.
LinkedIn, Wellfound, YC startup jobs에서 찾고, Apply를 눌러 지원 시스템(AshbyHQ, Greenhouse, Lever, Workday)으로 넘어가 이력서를 올리고 답변 초안을 채운 뒤 최종 제출 전에 내 확인을 기다립니다. 다른 예: LinkedIn에서 샌프란시스코의 AI 관련 Software Engineer 자리를 찾아 시니어 직함과 오래된 공고를 빼고, 지원 링크가 열려 있는 회사 10곳을 뽑기.
매물 찾고 비용 계산하기
도시·예산·주택 유형으로 매물을 거르고, 가장 맞는 매물을 열어 내 실제 계약금 기준으로 대출 상환액을 다시 계산합니다. 주소, 매물 가격, 예상 월 비용을 돌려줍니다.
Redfin, Zillow, Apartments.com에서 조건으로 거르고 대출·구매 여력 계산기를 돌린 뒤, 정리한 데이터를 내 컴퓨터의 Markdown 파일(간단한 기호로 꾸미는 글 파일)에 적게 할 수도 있습니다.
숫자 모으고 견주기
Yahoo Finance에서 미국 주식 5개의 가격·하루 변동·시가총액·1개월 수익률을 적고, 가장 많이 오른 종목과 내린 종목, 시가총액으로 가중한 하루 변동을 보고합니다.
Cars.com에서 뉴욕 근처 중고 Toyota Camry를 찾아 연식·주행 거리로 거르고, 계약금 5,000달러·60개월 조건으로 월 납입액을 계산합니다. Amazon 가격 비교, Costco 대량 주문, API가 사실상 닫혀 있는 증권사 관리 화면도 같은 방식으로 다룹니다.
다음은 양식을 채우거나 로그인 뒤의 화면을 다루는 쪽 셋과, 게임 사례 하나입니다.
검색부터 결제 직전까지
노선과 날짜로 항공편을 찾아 선호 항공사의 직항만 남기고, 가장 싼 것을 골라 탑승객 정보를 미리 채웁니다. 결제 페이지에서 멈추고 편명·출발 시각·총 요금을 알려 줍니다.
항공편·호텔·식당 예약 전체 흐름에서, 번거로운 양식을 내 실제 정보로 채우며 결제 페이지까지 가서 멈춥니다.
여러 관리 화면의 반복 작업
HubSpot, Salesforce, Notion, Airtable, Linear, Stripe, GA4, Search Console, Mixpanel 같은 SaaS(웹으로 쓰는 업무용 서비스)에서 보고서 뽑기, 대시보드 새로 고침, 항목 일괄 수정, 정해진 때에 보내기. 이런 서비스는 API를 다 열어 두지 않는 경우가 많고, 누구나 자동화를 직접 짤 수 있는 것도 아니라는 점이 이유입니다.
로그인 뒤에 있는 우리 회사 화면
직접 만든 관리자 화면, 스테이징(공개 전 시험용) 환경, QA(품질 점검) 흐름. 로그인에 막혀 다른 자동화 도구가 들어가지 못하는 페이지를, 내 평소 브라우저의 실제 로그인 상태를 물려받아 로그인된 채로 바로 들어갑니다.
체스 한 판 두기
Lichess에서 대국을 열고, 차례마다 판을 읽고, 초반·중반·종반에 맞춰 전략을 바꾸며 체크메이트·기권·무승부로 끝날 때까지 둡니다.
첫 화면이 드는 직무별 예 6가지
첫 화면은 “로그인된 탭에서 내가 할 수 있는 일은 에이전트도 할 수 있고, Space를 나눠 여러 작업을 한꺼번에 돌린다”며 직무별로 예를 듭니다.
| 직무 | 지금의 불편 | ego(lite)로 하면 |
|---|---|---|
| 개발(Coding) | Playwright식 스크립트는 페이지가 바뀌면 깨지고, 화면 없는 브라우저에는 내 로그인이 없습니다. | 에이전트가 로그인된 내 브라우저에서 시험합니다. 선택자나 로그인 스크립트를 관리할 필요가 없습니다. |
| 영업(Sales) | Sales Navigator, Salesforce 같은 곳은 데이터를 보여 주면서도 내보내기를 막거나 돈을 받아, 잠재 고객을 손으로 옮겨 적습니다. | 에이전트가 내 눈에 보이는 것을 읽어 필요한 곳에 씁니다. |
| 마케팅(Marketing) | 경쟁사 조사와 소셜 반응 살피기는 로그인한 채 탭 100개를 넘겨 보는 일입니다. | 에이전트가 내 로그인으로 글을 모아 분석합니다. |
| 재무(Finance) | 월말마다 Stripe, Shopify, 은행 등 수십 곳에 로그인해 청구서를 받습니다. | 에이전트가 청구서를 모으고 입금액을 주문과 맞춥니다. 승인과 지급은 여전히 내가 합니다. |
| 법무(Legal) | PACER 같은 판례 사이트에 로그인해 검색하고 PDF를 하나씩 읽습니다. | 에이전트가 내 로그인으로 이 일을 하고 인용 출처를 단 소송 문서를 돌려줍니다. 나는 판단과 분석에 집중합니다. |
| 조사(Research) | 조사 도구는 공개된 웹만 읽는데, 답은 Notion, Confluence, 대학 내부 사이트처럼 로그인 뒤에 있습니다. | 에이전트가 내 로그인으로 그 페이지를 읽고 출처를 밝힙니다. |
활용 사례 쪽에는 사례마다 00:23~00:39로 길이가 표시된 짧은 영상이 붙어 있습니다. 이 가이드는 영상 내용은 다루지 않고 쪽에 적힌 설명만 옮겼습니다.
자주 묻는 질문
첫 화면의 FAQ 10개입니다. 다른 곳에서 이미 답한 여섯 개는 첫 표에 짧게 적고 자세한 곳을 이어 두었습니다. 다른 도구와의 차이를 묻는 두 개는 둘째 표로, 나머지 두 개는 그 아래 문답으로 실었습니다.
| 질문 | 짧은 답 | 자세히 |
|---|---|---|
| ego(lite)가 무엇인가요? | Codex나 Claude Code 같은 AI 에이전트와 함께 쓰도록 만든 에이전트 브라우저입니다. 비용도 설정도 들지 않는다고 소개합니다. | 소개 |
| Claude Code, Codex, Cursor와 쓸 수 있나요? | 예. 셸 명령(터미널에 입력하는 명령)을 실행할 수 있는 에이전트면 됩니다. 원문이 든 예는 ego, Claude Code, Codex, Cursor, Continue, Gemini CLI, Hermes Agent, OpenClaw, OpenCode, 직접 만든 사내 에이전트입니다. ego-browser는 첫 실행 설정 때 에이전트의 스킬 폴더에 설치되고, 에이전트는 다른 셸 도구를 쓰듯 그 명령을 부릅니다. 통합할 SDK(다른 프로그램에 끼워 넣는 개발 도구 묶음)가 없고 특정 모델에 묶이지도 않습니다. | 5장 |
| Chrome의 북마크·비밀번호·확장 프로그램을 가져올 수 있나요? | 예. 첫 실행 설정에서 클릭 한 번으로 쓰던 탭과 탭 그룹, 북마크와 저장된 비밀번호, 확장 프로그램, 쿠키와 로그인 세션, 프로필을 옮깁니다. 로그인해 둔 사이트는 그대로이고 에이전트도 그 상태를 물려받아, Gmail·Notion·LinkedIn·사내 도구에 작업 때마다 다시 인증하지 않습니다. | 1장 |
| 에이전트가 일하는 동안 내 브라우저를 계속 써도 되나요? | 예. 에이전트는 Space에서 일하고, 내가 분명히 넘겨주지 않는 한 내 탭은 건드리지 않습니다. 마우스나 초점도 가져가지 않습니다. | 2장 |
| 에이전트가 쓸 때 내 데이터는 안전한가요? | ego(lite)는 내 컴퓨터에서 돌고 비밀번호·쿠키·북마크·방문 기록도 거기 저장됩니다. 에이전트가 작업한 페이지의 내용은 내가 고른 모델로 갑니다. | 개인정보 |
| Chrome 대신 주 브라우저로 써도 되나요? | 예. Chromium 기반이라 주소창, 탭 그룹, 북마크, 프로필, 확장 프로그램, 다운로드, 시크릿 모드가 Chrome처럼 동작합니다. 다른 점은 Space가 있다는 것입니다. | 내장 브라우저와 비교 |
| 무엇과 다른가 | 원문이 설명하는 그 도구 | 원문이 설명하는 ego(lite) |
|---|---|---|
| Playwright · Puppeteer | 코드에 넣어 쓰는 브라우저 자동화 라이브러리입니다. CSS 선택자(페이지 코드에서 요소를 가리키는 주소 표기)로 페이지를 다루는데, 사이트가 페이지 구조를 바꾸면 깨집니다. 도구를 하나 부를 때마다 왕복이 필요합니다. | 진짜 브라우저에 ego-browser를 더한 것입니다. 에이전트가 여러 단계를 엮은 짧은 JavaScript(웹 페이지에서 도는 프로그래밍 언어) 코드를 쓰면 ego-browser가 페이지에서 한 번에 실행합니다. 스냅샷은 HTML보다 토큰이 적게 들고, 번호표(@N)는 클래스 이름(페이지 코드에서 요소에 붙여 둔 이름)이 바뀌어도 그대로 쓸 수 있습니다. |
| Browser Use | 스스로 움직이는 에이전트 프레임워크입니다. 자체 AI 반복 실행 구조를 품고 별도의 브라우저를 조종합니다. 실제 Chrome에 연결할 수 있지만 Chrome을 완전히 닫은 뒤에만 되고, 확장 프로그램은 기본으로 불러오지 않으며, 이미 내는 비용 위에 자체 요금제가 있습니다. | ego, Claude Code, Codex, Cursor 등 어떤 에이전트를 쓰든 내가 매일 쓰는 바로 그 브라우저를 조종합니다. Space가 에이전트의 일과 내 일을 갈라 줍니다. |
| Vercel의 agent-browser | 에이전트가 셸 명령으로 브라우저를 조종하게 해 주는 CLI이지만, 자체 브라우저는 들어 있지 않습니다. 에이전트가 내 평소 브라우저 세션을 함께 쓰지 않아, 돌아가는 작업에서 내 실제 로그인을 쓸 수 없습니다. |
에이전트 브라우저란 무엇인가요?
사람만이 아니라 AI 에이전트가 조종하도록 만든 브라우저입니다. 사용자와 에이전트가 서로 방해하지 않고 동시에 쓸 수 있습니다. 에이전트는 처음부터 설정해야 하는 화면 없는 브라우저가 아니라 진짜 창과 탭, 그리고 (되도록) 내 로그인을 받습니다. ego(lite)는 매일 쓰는 Chromium에 Space를 더한 것이고, 이와 달리 Browser Use나 Puppeteer 같은 자동화 프레임워크는 내가 로그인해 둔 브라우저가 아닌 별도의 빈 브라우저를 조종한다고 원문은 설명합니다.
Playwright·Puppeteer와 다른 점 — 원문의 기술 설명
ego-browser는 에이전트 제품(Claude Code, Codex, Cursor, 직접 만든 것)과 ego(lite) 사이의 연결 층입니다. 브라우저를 페이지 안에서 도는 JavaScript 도구 묶음 — snapshot, fill, click, wait, navigate, capture — 으로 내놓습니다. 에이전트가 이 도구들을 엮은 JavaScript 조각을 쓰면 ego-browser가 한 번에 실행합니다. 통합해야 할 SDK(다른 프로그램에 끼워 넣는 개발 도구 묶음)가 없고, Playwright·Puppeteer 쪽에서 설치할 것도 없습니다. 원문은 FAQ 첫 답에서 Browser Use와 agent-browser를 “브라우저 자동화 프레임워크”로 묶어, 조종할 브라우저가 따로 필요하고 로그인이 깔끔하게 따라오지 않으며 나와 에이전트가 같은 탭을 두고 다투게 된다고도 적었습니다. 도구 목록과 동작 순서는 4장에 있습니다.
- 에이전트가 브라우저를 쓰는 도구는 확장 프로그램, 클라우드 브라우저, 에이전트 내장 브라우저, 브라우저 CLI, AI 브라우저 다섯 유형으로 나뉘고, 유형마다 잘 맞는 일이 따로 있습니다.
- ego(lite)는 브라우저 자체입니다. 내 컴퓨터에서 돌고, 내 로그인에서 시작하며, 에이전트는 자기 Space에서 일하고, 어떤 에이전트든 연결할 수 있습니다.
- ego(lite)도 CAPTCHA나 본인 확인을 우회하지 않고, 에이전트가 어떤 작업을 해도 되는지 정해 주지도 않습니다.
- Real-World Bench(실제 사이트 작업 31개)에서 완전 성공률 93.5%, 작업당 평균 398초, 평균 비용 1.64달러였습니다. 만든 회사가 직접 잰 수치입니다.
- 브라우저 데이터는 내 컴퓨터에 남고, 에이전트가 읽은 페이지 내용은 내가 고른 AI 모델로 갑니다. 계정과 이메일은 필요 없습니다.
- 앱은 무료이고 에이전트·모델 비용은 내가 냅니다. macOS 정식, Windows 베타, Linux 예정입니다.
- 사례는 자료를 모아 계산하는 일과 양식을 채우거나 로그인 뒤 화면을 다루는 일로 나뉘고, 지원·예약 사례에서는 에이전트가 제출 직전이나 결제 페이지에서 멈춥니다.
출처: lite.ego.app/document/en/docs/product-introduce (다른 도구와 비교 · Privacy · Platforms and price) · lite.ego.app (첫 화면 — 성능 수치 · 기능 비교표 · 직무별 예 · FAQ) · lite.ego.app/use-cases · lite.ego.app/document/en/docs/quick-start (What else can you do with ego(lite)) · lite.ego.app/document/en/docs/windows/quick-start · lite.ego.app/changelog (지원 환경 대목) · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준
부록 — 변경 내역 · 출처
ego(lite)는 며칠에 한 번꼴로 새 버전이 나옵니다. 이 부록은 변경 내역(Changelog) 쪽에서 사용자에게 의미 있는 변화를 골라 정리하고, 이 가이드가 근거로 삼은 문서 20쪽과 받지 못해 다루지 못한 것을 밝힙니다. 본문과 내 화면이 다르면 먼저 여기서 버전을 확인하세요.
- 최근 버전 표 — 버전, 날짜, 단계적 배포 표시, 한 줄 요약
- 주제별 주요 변경 — Space와 세션 복원, 데이터 가져오기, 에이전트·SDK·ego-browser, 설정과 실험 기능, 엔진 버전
- 이 가이드의 출처 20쪽과, 각 문서를 어느 장에서 썼는지
- 받지 않은 문서와 그래서 다루지 못한 내용
lite.ego.app/changelog에 있습니다.
최근 버전
버전 이름 옆에 “Staged rollout”이라고 붙은 것은 단계적 배포(모든 사용자에게 한꺼번에가 아니라 차례로 내보내는 방식을 가리키는 말) 중인 버전입니다. 원문은 이 표시의 뜻을 따로 풀이하지 않습니다. 0.6.x는 버전마다, 그 이전은 묶어서 적었습니다.
| 버전 | 날짜 | 단계적 배포 | 한 줄 요약 |
|---|---|---|---|
| 0.6.2.9 | 2026-11-06 | 표시 있음 | 0.6.2.8의 데이터 가져오기 변경을 되돌렸습니다. 데이터 가져오기는 0.6.2.7과 같은 방식으로 동작합니다. 이 버전의 변경은 이것 하나입니다. |
| 0.6.2.8 | 2026-11-05 | 표시 있음 | 실험 설정에 QUIC / HTTP/3 켜고 끄기 추가. 데이터 가져오기가 더 많은 종류의 원본 데이터를 처리하도록 바뀜(이 부분은 0.6.2.9에서 되돌림). 내용이 바뀌지 않았는데도 붙여넣기가 취소되던 문제 수정. |
| 0.6.2.7 | 2026-11-03 | — | 가져올 때 원래 브라우저의 기본 검색 엔진 유지. 쓸 수 없는 데이터는 건너뛰고 계속 가져옴. ego-browser import --data-path 추가. SDK의 페이지 이동 시간 초과 처리 개선. 실험 설정에 그래픽·비디오 관련 옵션 추가. |
| 0.6.2.5 | 2026-10-29 | 표시 있음 | 종료·재시작·비정상 종료 뒤 Space 복원 규칙 정리. 넘겨받기가 필요한 까닭을 에이전트에게 구체적으로 알림. 유리 창 스위치, 사용 데이터 공유 동의 묻기, SDK v2.2.0-beta.4, Chromium 156.0.8078.74. |
| 0.6.1.11 | 2026-10-26 | — | CDP 메시지가 64 KB를 넘으면 브라우저가 비정상 종료되던 문제 수정. |
| 0.6.1.9 | 2026-10-24 | — | Comet·Opera·Vivaldi·Yandex·Dia·Arc·Firefox·Zen에서 데이터 가져오기. On-device AI 스위치. Netflix·Spotify 같은 복사 방지 콘텐츠 재생. 에이전트 작업 중에는 컴퓨터와 화면이 잠들지 않음. Chromium 156.0.8078.48, Node.js v24.22.1. |
| 0.6.0.15 | 2026-10-19 | — | macOS에서 활성 창만 유리 배경을 보이게 해 성능 부담을 줄임. 단축키 안내 글자 여백 조정, 세로 탭 줄 단추 위치 수정. |
| 0.6.0.12 | 2026-10-15 | — | 세로 탭 줄 추가. 에이전트 작업 Space가 명령 없이 30분 지나면 자동으로 닫힘. 여러 브라우저를 한꺼번에 가져오기, Export data(데이터 내보내기) 추가. Chromium 154.0.8037.44, Node.js 24.21.0. |
| 0.5.1.11 ~ 0.5.1.13 | 2026-09-21 ~ 09-23 | — | Safari에서 북마크·방문 기록·비밀번호 가져오기. macOS iCloud 키체인에 저장된 패스키(Touch ID 포함)로 사이트 로그인. Space 전환 단축키 표시. macOS에서 Agent가 설치된 것으로 잘못 감지되던 문제 수정. |
| 0.5.0.28 ~ 0.5.0.32 | 2026-09-08 ~ 09-12 | — | Space 고정(pin), Space 전환 단축키 바꾸기, What's New 쪽. 스냅샷에 더 정밀한 페이지 구조 정보. 새 ego-browser 스킬과 도구 묶음. Chromium 152. macOS 27의 파일 권한 변경에 대응. |
| 0.4.7.1 ~ 0.4.7.4 | 2026-08-20 ~ 08-31 | — | 에이전트가 지금 Space를 조종하는 중에도 New Space 만들기. Memory Saver 기본 켜짐. 에이전트가 조종하는 동안 자막·번역 화면 숨김. 동시에 도는 ego-browser 작업의 연결 끊김 수정. |
| 0.4.6.12 ~ 0.4.6.14 | 2026-08-07 ~ 08-14 | — | 키보드로 Space 전환. Space를 새 창으로 열기, Space를 만들 때 Profile 고르기, 모든 Space 한꺼번에 지우기(실행 중인 작업 Space는 남김). 메모리를 지나치게 쓰던 문제 수정. |
| 0.4.5.5 ~ 0.4.5.9 | 2026-07-24 ~ 08-04 | — | 탭별 음소거. CLI가 서버 이름으로 특정 브라우저 인스턴스에 연결. 브라우저 데이터 자동 동기화 조건 정리. 창·Space 관련 안정성 수정. |
| 0.4.4.15 | 2026-07-17 | — | 에이전트 작업에 쓸 브라우저 Profile 지정. “Keep browser data up to date” 설정. Space 카드에 작업 실행 상태 표시. 에이전트가 만든 작업 탭은 기본 음소거. |
| 0.4.2.21 ~ 0.4.3.9 | 2026-06-24 ~ 07-02 | — | 첫 설치 뒤 명령줄 도구 설정을 안내하는 환영 쪽. F12로 개발자 도구 열기. 첨부 파일을 기본 데스크톱 앱으로 열기. 데이터 가져오기 안정화. (0.4.2.21은 0.4.1.3부터, 0.4.3.9는 0.4.2.21부터의 변경을 묶은 것) |
받은 파일에 함께 들어 있는 Windows 탭의 버전 목록
변경 내역 쪽은 macOS와 Windows 탭으로 나뉩니다. 받은 파일에는 Windows 탭의 0.6.x 목록도 들어 있습니다: 0.6.2.8(단계적 배포) · 0.6.2.7 · 0.6.2.5(단계적 배포) · 0.6.1.13 · 0.6.1.11 · 0.6.1.9 · 0.6.0.22 · 0.6.0.20 · 0.6.0.16 · 0.6.0.15. 수집 시점의 Windows 목록에는 0.6.2.9가 없습니다. macOS 탭에 없는 버전은 넷입니다.
- 0.6.1.13(2026-10-26) — Windows에서 다른 브라우저의 데이터 가져오기가 실패하던 일부 경우 수정
- 0.6.0.22(2026-10-23) — 표준 사용자 권한으로 낮춘 뒤 명령줄이 브라우저에 연결하지 못하던 오류 수정(UAC를 끄고 브라우저를 관리자로 실행하는 소수 사용자에게 해당)
- 0.6.0.20(2026-10-23) — 첫 실행 설정의 기본 브라우저 지정 개선, 끝내지 않은 첫 실행 설정 창을 닫으면 앱이 종료되고 다음 실행 때 다시 표시, 온라인 설치 프로그램이 시스템 언어를 따름, 관리자 터미널에서 실행한 명령이 표준 사용자 권한의 하위 프로세스로 연결
- 0.6.0.16(2026-10-19) — 일부 Windows 컴퓨터에서 ego-browser가 바로 비정상 종료되던 문제 수정
같은 번호의 버전도 Windows 탭에는 Windows에만 해당하는 항목이 섞여 있습니다. 이 부록의 나머지는 macOS 탭만 다룹니다.
주제별 주요 변경
버전 순서가 아니라 “무엇이 달라졌나”로 다시 묶었습니다. 괄호 안은 그 변화가 들어온 버전입니다.
Space · 세션 복원
- 브라우저를 껐다 켜면 Space가 어떻게 되나 (0.6.2.5) — 정상 종료 뒤에는 Profile(프로필 — 브라우저 안의 사용자 묶음)마다 정해 둔 시작 설정을 따릅니다. “Open the New Tab page”(새 탭 페이지 열기)와 “Open a specific page or set of pages”(특정 페이지 열기)는 고정한 Space만 남기고, “Continue where you left off”(하던 곳에서 계속)는 현재 Space도 남깁니다. Spaces Overview(Space를 모아 보는 화면)에서 종료하면 모든 Space가 남습니다.
- 업데이트로 재시작할 때 (0.6.2.5) — 모든 Space와 현재 세션을 유지하고, 시작 페이지를 따로 더 열지 않습니다.
- 비정상 종료 뒤 (0.6.2.5) — “Restore pages”(페이지 복원)를 고르면 다른 Profile의 Space까지 복원하고 고정한 Space부터 되살립니다. 복원하지 않으면 그 Space들은 닫힌 채로 있습니다.
- 30분 자동 닫힘 (0.6.0.12) — 에이전트 작업 Space는 명령 없이 30분이 지나면 자동으로 닫힙니다. 고정한 Space, 내가 만든 Space, 작업 중에 이미 나에게 넘겨진 Space는 해당하지 않습니다.
- Space 고정 (0.5.0.28) — 고정 상태·순서·세션 데이터가 재시작 뒤에도 복원됩니다. Space를 정리할 때 고정한 것은 남고, 고정한 Space를 닫을 때는 먼저 확인을 받습니다.
- 에이전트가 만든 Space의 보존 (0.4.6.12, 0.4.7.1) — 작업이 끝나거나 멈추거나 실패한 뒤에도 세션 복원 대상에 들어가, 남겨 둔 작업 Space가 재시작 뒤 돌아옵니다.
- 내 일과 섞이지 않게 (0.4.4.15, 0.4.5.8) — 에이전트 작업 밖에서 연 주소는 일반 창에서 열리고, 에이전트가 현재 Space를 쓰는 중이면 Settings 같은 내 페이지는 같은 Profile의 일반 Space에서 열립니다. 작업 Space의 마지막 탭을 닫으면 그 Space는 바로 없어집니다.
- 키보드로 Space 전환 (0.4.6.12 → 0.4.6.13, macOS) — ⌥ Option+S로 Space 관리 화면을 열고, ⌥ Option을 누른 채 S나 좌우 화살표를 눌러 빠르게 옮깁니다. 0.5.0.28부터는 이 단축키를 바꿀 수 있습니다.
Space의 수명과 작업 뒤 처리는 2장에서 설명합니다.
데이터 가져오기
- 가져올 수 있는 브라우저가 늘었습니다 — Safari의 북마크·방문 기록·비밀번호(0.5.1.11), Comet·Opera·Vivaldi·Yandex·Dia·Arc·Firefox·Zen(0.6.1.9). 가져오기 도움말에는 Chrome·Edge·Brave가 적혀 있습니다(0.6.0.12). Firefox와 Zen의 확장 프로그램은 가져오지 않는다고 첫 실행 설정에 명시했습니다(0.6.2.5).
- 가져오는 항목이 늘었습니다 — 읽기 목록과 사이트 권한 설정, 비밀번호 메모(0.6.1.9), 원래 브라우저의 기본 검색 엔진(0.6.2.7).
- 일부가 잘못돼도 전체가 실패하지 않습니다 (0.6.2.7) — 오래되거나 깨진 데이터베이스, 형식이 잘못된 쿠키, 읽을 수 없는 확장 프로그램 등은 그 항목만 건너뛰고 계속합니다. 실패하면 어떤 종류의 데이터가, 어느 단계에서, 어느 파일 때문에 막혔는지 더 구체적으로 보여 줍니다.
- 여러 브라우저를 한꺼번에 (0.6.0.12) — 기존 Profile은 기본으로 그대로 두고, 가져올 때마다 새 Profile을 만듭니다. 기존 Profile을 지우도록 고르면 가져오기가 성공한 뒤에야 재시작하며 옛 데이터를 지웁니다. 결과는 완전 성공·부분 성공·데이터 손실로 구분해 알려 줍니다.
- 주기적으로 맞추기 (0.4.4.15, 0.4.5.5) — “Keep browser data up to date” 설정을 켜면 찾아낸 원래 브라우저에서 북마크·방문 기록 같은 지원 데이터를 주기적으로 가져옵니다. 자동 동기화는 ego(lite)가 기본 브라우저가 아니고 동기화 간격이 지났을 때만 돕니다.
- 되돌려진 변경 (0.6.2.8 → 0.6.2.9) — 0.6.2.8의 가져오기 변경은 0.6.2.9에서 되돌려졌습니다.
가져오기 방법은 1장에 있습니다.
에이전트 · SDK · ego-browser
- 넘겨받기가 필요한 까닭을 알려 줍니다 (0.6.2.5) — 페이지가 클립보드, 로컬 네트워크, 저장소 접근, 창 관리, 로컬 글꼴 같은 권한을 요청하면, 모두 뭉뚱그려 “직접 넘겨받으세요”라고 하지 않고 구체적인 사유를 에이전트에게 전합니다.
- 작업 중에는 잠들지 않습니다 (0.6.1.9) — 에이전트 작업이 도는 동안 컴퓨터와 화면이 절전 상태로 들어가지 않습니다.
- 복사 방지 콘텐츠는 찍지 못합니다 (0.6.1.9) — 페이지가 DRM(복사 방지 기술)으로 보호된 콘텐츠를 불러온 뒤에는 ego-browser와 에이전트가 그 페이지를 화면 캡처·녹화·PDF 인쇄할 수 없습니다. 내가 직접 연 개발자 도구는 영향받지 않습니다.
- 조종 중 방해 줄이기 (0.4.6.12, 0.4.7.1, 0.5.0.32) — 에이전트가 Space를 조종하는 동안 작업을 흐트러뜨릴 단축키를 막고, 페이지를 떠날 때의 확인 창·파일 선택 창·자격 증명 창 등이 작업을 끊지 않게 했습니다. 그동안 주소창은 읽기 전용이고, 작업이 끝나거나 내가 넘겨받으면 바로 다시 쓸 수 있습니다.
- 스냅샷과 도구 (0.5.0.28, 0.6.2.5) — 스냅샷에 더 정밀한 페이지 구조 정보가 담기고, 새 ego-browser 스킬과 도구 묶음이 들어왔습니다. 기본 스냅샷은 화면 밖에 내용이 더 있으면 그 사실을 알려 줍니다.
- Profile 지정과 자동 맞춤 (0.4.4.15) — 에이전트 작업을 특정 브라우저 Profile로 돌릴 수 있고, 브라우저를 업데이트하면 ego-browser와 에이전트 연동도 그 버전에 자동으로 맞춰집니다.
SDK와 명령줄 도구의 세부 변경
- 0.6.2.7 — SDK의 페이지 기록을 버전별 파일로 나눠 쓰기 실패를 줄임. npm 패키지와 Agent 플러그인이 각자 버전 번호를 가짐.
goto()가 시간을 넘기면 아직 확정되지 않은 이동을 멈춰 Page가 이전 문서에 머물고, 응답 제한 시간을 넘긴 이동은 멈춘 뒤 “페이지가 응답하지 않음” 오류를 돌려줌.ego-browser import --data-path로 Chromium 기반 브라우저의 데이터 폴더를 지정 - 0.6.2.5 — SDK v2.2.0-beta.4: 페이지 기록을 브라우저 인스턴스별로, 기본 화면 캡처 경로를 실행별로 분리하고 다운로드 폴더는 공유해 서로 덮어쓰지 않음. 네트워크가 잠잠해지기를 기다리다 시간을 넘기면 끝나지 않은 요청을 보고. 세션 초기화에 제한 시간. 문서가 바뀌는 사이에 걸친 스냅샷은 자동 재시도. 마우스 휠로 대상을 보이게 할 수 없으면 다른 스크롤 방법 사용, 동작 안의 고정 대기 제거. 이름을 바꾼 적 없는 사용자 Space를 SDK가 나열하고 차지할 수 있음. 명령줄에 macOS 사용 안내 포함. 플러그인 npm 패키지가
@ego-lite범위로 이동 - 0.6.2.5 수정 — 스크립트나
-e를 주었는데도 ego-browser가 표준 입력을 기다리던 문제, 마지막 Page를 닫은 뒤 빈 탭이 남아finish()정리가 끝나지 않던 문제 - 0.6.1.11 — 64 KB보다 큰 CDP(Chrome DevTools Protocol — 브라우저를 바깥에서 조종하는 통신 규약) 메시지에서 브라우저가 비정상 종료되던 문제
- 0.5.1.11 — 에이전트의 파일 작업에서 절대 경로나
~/로 위치 지정 - 0.4.5.5 — CLI가 서버 이름으로 특정 브라우저 인스턴스에 연결(여러 Profile·에이전트·인스턴스 환경). ego-browser Node.js 스크립트가 실패했는데 바깥 CLI가 성공으로 보고하던 문제, CDP 연결로
Target.createTarget을 써서 새 브라우저 대상을 만들 수 있던 문제 수정 - 0.4.6.12 · 0.4.7.4 — 동시에 도는 에이전트 작업에서 한 Node 실행이 끝날 때 다른 작업의 연결이 끊기던 문제 수정.
task-spaces출력에 Profile ID와 이름 포함
ego-browser의 동작은 4장, 스냅샷은 3장, 에이전트 연결은 5장에서 설명합니다.
설정 · 실험 기능 · 화면
| 무엇 | 버전 | 내용 |
|---|---|---|
| QUIC / HTTP/3 실험 | 0.6.2.8 | 실험 설정에서 켜고 끌 수 있습니다. 기본값은 Chromium의 구성을 따릅니다. |
| Skia Graphite · 하드웨어 비디오 처리 실험 | 0.6.2.7 | Skia Graphite 옵션과, 하드웨어 비디오 디코딩·인코딩을 끄는 옵션이 생겼습니다. 옵션이 생겼다는 것이지 기본으로 켜졌다는 뜻이 아닙니다. |
| AI · 온디바이스 모델 실험 | 0.6.2.5 | 기기에서 도는 AI 모델을 기본으로 내려받는 동작을 끌 수 있습니다. |
| On-device AI 스위치 | 0.6.1.9 | 끄면 로컬 AI 모델을 더 내려받지 않고, 이미 받은 모델은 지웁니다. |
| 유리 창 스위치 | 0.6.2.5 | Appearance(모양) 설정에 있습니다. 기본은 꺼짐이고, 바꾸면 재시작한 뒤 적용됩니다. 0.5.0.28에는 실험 기능으로 들어 있었습니다. |
| 사용 데이터 공유 동의 | 0.6.2.5 | 첫 실행 설정에서 고르지 않았다면 동의를 묻습니다. Agree(동의)나 Not now(나중에)를 고르면 다시 묻지 않습니다. 설정의 “Help improve ego's features and performance” 항목과 맞춰집니다. |
| 업데이트 알림 | 0.6.2.5 | 업데이트가 준비되면 도구 모음의 업데이트 단추가 강조되고 “Later”(나중에)와 “Restart now”(지금 재시작)를 고릅니다. |
| 세로 탭 줄 | 0.6.0.12 | 첫 실행 설정이나 Settings에서 가로·세로를 바꿉니다. 접으면 완전히 숨고, 포인터를 창 왼쪽 가장자리에 대면 펼쳐집니다(0.6.2.5부터 항상). |
| Export data | 0.6.0.12 | Settings에 데이터 내보내기 항목이 생겼습니다. 별도 창에서 진행됩니다. |
| 패스키 | 0.5.1.12 | macOS iCloud 키체인에 저장한 패스키로, Touch ID를 포함해 사이트에 로그인합니다. |
| 복사 방지 콘텐츠 재생 | 0.6.1.9 | Netflix, Spotify 같은 서비스의 보호된 영상·음악이 재생됩니다. |
| Memory Saver · 탭 음소거 | 0.4.7.1 · 0.4.5.5 | Memory Saver가 기본으로 켜지고, 탭마다 따로 소리를 끌 수 있습니다. |
0.6.2.5에는 기본으로 꺼져 있는 Halloween Agent 깜짝 애니메이션도 들어갔습니다. 내가 넘겨받거나 작업이 끝나면 숨고, 페이지 화면 캡처에는 나오지 않습니다.
엔진 버전
ego(lite)의 바탕인 Chromium과, ego(lite)에 내장된 Node.js(JavaScript를 실행하는 프로그램)의 버전입니다. 변경 내역에 버전이 적힌 경우만 모았습니다.
| ego(lite) | Chromium | 내장 Node.js |
|---|---|---|
| 0.6.2.5 | 156.0.8078.48 → 156.0.8078.74 | v24.22.1 (그대로) |
| 0.6.1.9 | 156.0.8078.48 | v24.22.1 |
| 0.6.0.12 | 152.0.7977.54 → 154.0.8037.44 | 24.18.1 → 24.21.0 |
| 0.5.0.28 | 152 | (언급 없음) |
버전별 원문 요약
위에서 다루지 않은 화면 다듬기와 오류 수정까지 버전별로 간추렸습니다. 한 줄짜리 버전(0.6.2.9, 0.6.1.11, 0.6.0.15)은 맨 위 표가 전부입니다.
0.6.2.8 (2026-11-05, 단계적 배포)
- 기능 — 실험 설정에 QUIC / HTTP/3 옵션
- 개선(0.6.2.9에서 되돌림) — 더 새로운 데이터베이스 구조의 브라우저에서 가져올 때 검색 엔진 데이터 유지, 옛 방식으로 암호화된 Firefox 비밀번호 저장소 지원, 읽을 수 없는 개별 파일·기록은 건너뜀, 명령줄 가져오기는 다른 가져오기가 도는 중이면 시작하지 않음, 실패 진단을 더 자세히
- 수정 — 형식이 잘못된 검색 엔진 표를 읽다 비정상 종료되던 문제, 같은 원본 폴더가 여러 번 나열되던 문제, 클립보드 내용이 그대로인데 붙여넣기가 취소되던 문제
0.6.2.7 (2026-11-03)
- 기능 — 가져올 때 기본 검색 엔진 유지, 실험 설정에 Skia Graphite와 하드웨어 비디오 디코딩·인코딩 끄기
- 개선 — 쓸 수 없는 데이터를 건너뛰고 계속 가져오기, Edge 주소와 옛 세션 데이터 호환, Opera 확장 프로그램 검사 강화, 이전 가져오기의 임시 데이터 정리, 실패 시 더 구체적인 안내,
ego-browser import --data-path, 사용 데이터 동의 말풍선·업데이트 단추·Citro Labs 서비스 설정의 디자인과 문구, SDK 페이지 기록과 이동 시간 초과 처리 - 수정 — 사용 데이터 동의 말풍선 둘레의 투명한 영역이 도구 모음 클릭을 막던 문제
0.6.2.5 (2026-10-29, 단계적 배포)
- 기능 — 유리 창 스위치, 실험 설정의 AI·온디바이스 모델 옵션, Halloween Agent 애니메이션, 사용 데이터 공유 동의 묻기, SDK가 이름을 바꾼 적 없는 사용자 Space를 나열·차지
- 개선 — Space 복원 규칙(정상 종료·재시작·비정상 종료), Spaces Overview를 닫은 뒤 보이지 않는 미리 보기 캡처 중단, 접힌 세로 탭 줄은 창 가장자리에서 항상 펼쳐짐, 최대화·전체 화면에서 화면 맨 위를 눌러 가로 탭 선택, Firefox·Zen 확장 프로그램은 가져오지 않는다는 안내, Firefox Profile 묶음과 같은 브라우저 여러 설치 지원, 빠진 범주를 알려 주는 가져오기 결과, 넘겨받기 사유 전달, SDK v2.2.0-beta.4, 업데이트 단추 강조, Chromium 156.0.8078.74
- 수정 — Spaces Overview에서 만든 새 창·Space가 옛 세션을 복원하던 문제, 메뉴와 도움말 풍선이 단추에서 떨어져 나타나던 문제, 첫 실행 설정의 개인정보 링크가 반응하지 않던 문제, 여러 원본에서 가져올 때 진행률이 뒤로 가던 문제, 종료를 시작한 뒤에도 업데이트 확인이 돌던 문제
0.6.1.9 (2026-10-24)
- 기능 — On-device AI 스위치, 여덟 브라우저에서 가져오기와 읽기 목록·사이트 권한 설정, 복사 방지 콘텐츠 재생
- 개선 — Chromium 156.0.8078.48과 Node.js v24.22.1, 첫 실행 설정의 가져오기 흐름, 비밀번호 메모 유지와 Edge의 새 암호화 형식 지원, 에이전트 작업 중 절전 방지, DRM 콘텐츠의 캡처·녹화·PDF 인쇄 차단, Profile 목록에서 ego(lite) 내부용 Profile 숨김
- 수정 — Spaces Overview에서 새 창으로 연 Space가 현재 화면에 나타나지 않던 문제, 뒤쪽 Space의 탭 변화가 초점을 가져가던 문제, 가져온 뒤 시작 페이지·홈 페이지·고정 탭·검색 엔진 설정이 초기화되던 문제, 원래 브라우저도 풀지 못하는 데이터 때문에 가져오기 전체가 실패하던 문제, 스냅샷을 찍는 중 등에 생기던 비정상 종료
0.6.0.12 (2026-10-15)
- 기능 — 세로 탭 줄과 탭 그룹 지원, 떠 있는 탭 줄의 고정 탭을 아이콘 격자로, Export data, 에이전트 작업 Space 30분 자동 닫힘
- 개선 — 세로 탭 줄·탭 그룹·떠 있는 탭 줄의 모양과 동작, 재시작 때 고정하지 않은 것까지 저장된 모든 Space 복원, 창을 닫으며 Space를 다른 창으로 옮길 때 탭 그룹·고정 탭 유지, Spaces Overview가 열린 동안 키보드 입력과 탭 단축키 무시, 조종 표시가 Space를 펼치고 접는 동안에도 보임, 여러 브라우저 한꺼번에 가져오기와 결과 구분, Chromium 154.0.8037.44와 Node.js 24.21.0
- 수정 — 세로 탭 줄 너비 조절과 분할 보기 탭이 든 Space를 닫을 때의 비정상 종료, 숨은 Space의 대화 상자가 남던 문제, 에이전트가 작업 탭을 만들 때 숨은 창이 나타나던 문제, 자동화로 받은 파일이 일반 다운로드 기록과 저장 위치를 따르지 않던 문제, 방문 기록을 가져온 뒤 동기화 정리로 기록이 지워지던 문제
0.5.x (2026-09-08 ~ 09-23)
- 0.5.1.13 — macOS에서 Agent가 설치된 것으로 잘못 감지되어 브라우저 기능이 오작동하던 문제 수정, 옛 버전이 남긴 잘못된 설정 자동 정리
- 0.5.1.12 — macOS iCloud 키체인의 패스키로 로그인(Touch ID 포함)
- 0.5.1.11 — Safari에서 가져오기, Spaces Overview에 Space별 전환 단축키 표시, Chromium 기반 브라우저 가져오기 정확도 개선, 에이전트 파일 작업의 절대 경로·
~/지원, 가져온 뒤 일부 쿠키를 읽지 못하던 문제와 여러 비정상 종료 수정 - 0.5.0.32 — 첫 실행 설정과 가져오기 개선, macOS 27 파일 권한 변경 대응, 고정한 Space가 복원되지 않던 문제, 에이전트 조종 중 주소창이 읽기 전용으로 유지되지 않던 문제 수정
- 0.5.0.28 — Space 고정, Spaces Overview의 미디어 재생 상태, Space 전환 단축키 바꾸기, What's New 쪽, 가상 머신·원격 데스크톱에서 Space 미리 보기 표시, 더 정밀한 스냅샷, 실험적 유리 창 배경, 새 ego-browser 스킬과 도구 묶음, Chromium 152, 확장 프로그램 단축키가 Space 단축키를 덮어쓰던 문제 수정
0.4.x (2026-06-24 ~ 08-31)
- 0.4.7.1 ~ 0.4.7.4 — 에이전트 조종 중 New Space 만들기, 작업 뒤 Space 보존·복원 안정화, 숨은 Space의 팝업·권한 요청이 현재 동작을 끊지 않음, Memory Saver 기본 켜짐, 조종 중 자막·번역 화면 숨김, Space 전환 단축키를 일반 사용자 Profile에서만 사용, 동시에 도는 ego-browser Node.js 작업의 연결 끊김 수정
- 0.4.6.12 ~ 0.4.6.14 — 키보드 Space 전환과 그 조정, Space를 새 창으로 열기, Space를 만들 때 Profile 고르기, 모든 Space 한꺼번에 지우기, 에이전트 감지 속도 개선, 조종 중 방해되는 단축키·화면 차단, 0.4.6.12에서 생긴 메모리 과다 사용 수정
- 0.4.5.5 ~ 0.4.5.9 — 탭별 음소거, 서버 이름으로 특정 브라우저 인스턴스 연결, 자동 동기화 조건, macOS 설치 화면 개선, 에이전트가 현재 Space를 쓰는 중이면 내 페이지를 일반 Space에서 열기, 여러 창·Space 관련 수정
- 0.4.4.15 — 작업에 Profile 지정, “Keep browser data up to date”, Space 카드의 작업 상태, 작업 Space의 마지막 탭을 닫으면 Space 제거, 가져오기가 끝나면 새 Profile 창 열기, 넘겨받은 뒤 브라우저 단축키 복원, 작업 탭 기본 음소거, 가져온 테마가 ego(lite) 모양을 덮어쓰지 않음, 업데이트 뒤 ego-browser 자동 맞춤
- 0.4.2.21 ~ 0.4.3.9 — 환영 쪽, F12 개발자 도구, 첨부 파일을 기본 앱으로 열기, 작업 진행 표시와 전환 효과, 전체 화면 탭 줄 동작, 가져오기 안정화, 업데이트 알림을 더 일찍 표시
이 가이드의 출처
이 가이드는 아래 20쪽만을 근거로 썼습니다. 모두 2026-11-09에 받았고, 문서 쪽은 영어판입니다(macOS 판 16쪽 전부와 Windows 판 빠른 시작 1쪽). 영어판을 고른 까닭은 다른 언어판이 번역본이고, 명령과 메뉴 이름이 영어 화면 기준이기 때문입니다.
| 문서 | 주소 | 무슨 내용인가 | 쓴 곳 |
|---|---|---|---|
| 사이트 첫 화면 | lite.ego.app | 소개, 성능 비교, 기능, 비교표, FAQ | 소개 · 1 · 3 · 4 · 7장 |
| What is ego(lite) | lite.ego.app/document/en/docs/product-introduce | ego(lite)란 무엇인가 — 동작 원리, 다른 도구와 비교, 개인정보, 가격 | 소개 · 2 · 3 · 4 · 7장 |
| Quick start | lite.ego.app/document/en/docs/quick-start | 빠른 시작 — 설치, 에이전트 연결, 첫 작업, 지켜보고 넘겨받기 | 1 · 2 · 7장 |
| Quick start (Windows) | lite.ego.app/document/en/docs/windows/quick-start | Windows 판 빠른 시작 | 1장 · 소개와 7장의 지원 환경 대목 |
| Space | lite.ego.app/document/en/docs/space | 에이전트 전용 작업 공간 | 2 · 3장 |
| Snapshot | lite.ego.app/document/en/docs/snapshot | 스냅샷과 번호표(@N) | 3장 |
| ego-browser | lite.ego.app/document/en/docs/ego-browser | 브라우저를 조종하는 명령 도구 | 4장 |
| Skills | lite.ego.app/document/en/docs/skills | 스킬 — 에이전트에게 주는 사용 설명서 | 4장 |
| … with Claude Code | lite.ego.app/document/en/docs/claude-code | Claude Code에서 쓰는 법 | 5장 |
| … with Codex | lite.ego.app/document/en/docs/codex | Codex에서 쓰는 법 | 5장 |
| … with Cursor | lite.ego.app/document/en/docs/cursor | Cursor에서 쓰는 법 | 5장 |
| … with OpenCode | lite.ego.app/document/en/docs/opencode | OpenCode에서 쓰는 법 | 5장 |
| … with WorkBuddy | lite.ego.app/document/en/docs/workbuddy | WorkBuddy에서 쓰는 법 | 5장 |
| … with Hermes Agent | lite.ego.app/document/en/docs/hermes-agent | Hermes Agent에서 쓰는 법 | 5장 |
| … with OpenClaw | lite.ego.app/document/en/docs/openclaw | OpenClaw에서 쓰는 법 | 5장 |
| … with DeepSeek Harness | lite.ego.app/document/en/docs/deepseek-harness | DeepSeek Harness에서 쓰는 법 | 5장 |
| … with your own agent harness | lite.ego.app/document/en/docs/custom-agent-harness | 직접 만든 에이전트 프로그램에 연결하는 법 | 6장 |
| … with local model | lite.ego.app/document/en/docs/qwen-local | 내 컴퓨터에서 도는 모델로 쓰는 법 | 6장 |
| What you can automate | lite.ego.app/use-cases | 활용 사례 8가지 | 7장 |
| Changelog | lite.ego.app/changelog | 버전별 변경 내역 | 2장 · 7장의 지원 환경 대목 · 이 부록 |
“… with ○○”는 원문 제목 “How to use ego(lite) with ○○”를 줄인 것입니다. 첫 화면은 쪽 목록을 조회할 때 함께 받은 것을 글로 바꿔 저장했고, 나머지 19쪽은 브라우저에서 읽은 결과입니다. 쪽 목록은 사이트가 내놓는 문서 색인(언어 12개 × 32쪽)과 사이트 지도(530쪽)에서 뽑았습니다.
이 가이드가 다루지 못한 것
받을 쪽 수에 상한(20쪽)을 두었기 때문에 아래 문서는 받지 않았습니다. 이 가이드에 없는 내용이 곧 “없는 기능”이라는 뜻은 아닙니다.
| 받지 않은 것 | 그래서 이 가이드에 없는 것 |
|---|---|
| Windows 판 문서 나머지 15쪽 | Windows에서의 Space·스냅샷·에이전트별 설정 같은 세부. Windows는 빠른 시작 1쪽만 받아 1장에만 적었습니다. 다른 장의 화면과 경로는 macOS 기준이고 Windows에서는 다를 수 있습니다. |
| 한국어 등 번역 문서 | 한국어판 문서의 용어와 표현. 이 가이드의 한국어 용어는 영어 원문을 직접 옮긴 것이라 공식 한국어판과 다를 수 있습니다. |
| Solutions(/solutions) 21쪽 | 직무·상황별 해결책 안내 |
| Article(/article) 111쪽 · Blog(/blog) 5쪽 | 개별 글. 제품 소개 문서가 더 읽을거리로 든 제작 배경 글도 받지 않았습니다. |
| 제품별 비교(/compare) | Playwright, Browserbase, Claude in Chrome 등 개별 제품과의 세부 비교. 7장은 유형 수준의 비교까지만 다룹니다. |
| Enterprise(/enterprise) | 기업용 안내 |
| Roadmap(/roadmap) | 앞으로의 계획. 이 가이드에서 “곧 제공 예정”이라고 적은 것은 받은 문서에 그렇게 적힌 것(경험 쌓기, Linux 판)뿐입니다. |
| Download(/download) · Team(/team) | 내려받기 쪽의 세부와 만든 사람들 소개 |
| Privacy Policy · Terms of service | 개인정보 처리방침과 이용 약관. 7장은 제품 소개 문서의 Privacy 절까지만 옮겼습니다. |
| 변경 내역의 Windows 탭 | 받은 파일에 0.6.x 목록이 함께 들어 있지만, 이 부록은 macOS 탭을 기준으로 정리했습니다. |
lite.ego.app/changelog에서 그 뒤 변경을 찾아보세요. 문서의 최신판은 lite.ego.app/document에 있습니다.
- 이 가이드는 ego(lite) 0.6.2.7 무렵 문서 기준이고, 수집 시점의 최신 버전은 0.6.2.9입니다.
- 0.6.2.9는 0.6.2.8의 데이터 가져오기 변경을 되돌린 버전이라, 가져오기는 0.6.2.7과 같게 동작합니다.
- 최근 변화의 큰 줄기는 Space 복원 규칙 정리, 가져올 수 있는 브라우저 확대, 넘겨받기 사유 전달, 실험 설정 추가입니다.
- 에이전트 작업 Space는 명령 없이 30분이 지나면 자동으로 닫히고(0.6.0.12부터), 고정한 Space는 재시작 뒤에도 남습니다.
- 출처는 공식 사이트의 20쪽이며, Windows 세부·번역판·Solutions·Article·Blog·Enterprise·Roadmap·Privacy Policy는 받지 않아 다루지 못했습니다.
출처: lite.ego.app/changelog (macOS 탭 전체, Windows 탭은 0.6.x 버전 목록과 macOS 탭에 없는 네 버전만) · 이 주제의 원문 목록 sources/INDEX.md · 수집일 2026-11-09, ego(lite) 0.6.2.7 무렵 문서 기준(변경 내역 맨 위는 0.6.2.9)