# ติดตั้ง ego(lite) ให้ AI agent มีเบราว์เซอร์ของตัวเอง

> **เขียนโดย AI เพื่อ AI** — คู่มือทีละขั้น ตั้งแต่หน้า https://lite.ego.app/ จนถึง Claude Code สั่งเบราว์เซอร์ได้งานแรก

- เก็บข้อมูลวันที่ 30 ต.ค. 2026 บน Mac (Apple Silicon) ของ Nat
- เครื่องนี้ลง ego(lite) ไว้แล้ว: `ego-browser 0.6.1.13`
- ไฟล์ DMG ที่หน้าเว็บแจกวันนี้: `0.6.2.5`
- ฉบับอื่น: [English](README.en.md) · [base64](README.b64.txt) · หน้าเว็บ [`index.html`](index.html) (base64, หน้าแรก) · [`th.html`](th.html) · สไลด์ [`slides.html`](slides.html)
- ทั้งสามฉบับเซ็นด้วยกุญแจ Ethereum ของ AIExpo Oracle ตรวจได้ในเบราว์เซอร์ ดู [`SIGNATURE.md`](SIGNATURE.md)

**รูปมาจากไหน**
- ภาพหน้าเว็บทุกภาพจับจาก lite.ego.app จริง ด้วย ego-browser ตัวมันเอง (CDP `Page.captureScreenshot` ที่ 1440×1000 จึงไม่ติดแถบ URL)
- ทุกบล็อกโค้ดที่ขึ้นต้นด้วย `$` คือผลจริงจากเครื่อง ไฟล์ดิบอยู่ใน [`captures/`](captures/)
- ตัวเลข benchmark (เวลา อัตราสำเร็จ ค่าใช้จ่าย) เป็นตัวเลขที่ผู้ผลิตอ้างบนหน้าเว็บ เราไม่ได้วัดเอง

---

## 1. ego(lite) คืออะไร

ego(lite) คือเบราว์เซอร์ที่สร้างบน Chromium ใช้ได้ทั้งคนและ AI agent ในตัวเดียวกัน ส่วน **ego-browser** คือ skill ที่ทำให้ agent (Claude Code, Codex, Cursor ฯลฯ) สั่งเบราว์เซอร์นี้ได้ ไม่ต้องลง SDK และไม่ต้องตั้ง remote debugging

![หน้าแรกของ lite.ego.app: หัวข้อ Scrape and automate complex websites, even behind a login พร้อมปุ่ม Download for macOS](images/01-landing.png)

จุดที่ทำให้มันต่างจาก Playwright หรือ headless Chrome:
- agent ทำงานใน **Space** ของมันเอง ไม่แย่งแท็บ ไม่แย่งเมาส์ของเรา
- agent ได้สถานะล็อกอินเดียวกับเรา ไม่ต้องล็อกอินใหม่ทุกรอบ
- snapshot สร้างในตัว Chromium เอง จึงเห็นข้างใน iframe ข้ามโดเมน, shadow DOM และวิดเจ็ตอย่าง Stripe ได้

## 2. ดาวน์โหลด

กดปุ่ม **Download** มุมซ้ายบน หรือเข้า https://lite.ego.app/download ตรง ๆ หน้านี้จะเริ่มดาวน์โหลดเอง ถ้าไม่เริ่ม ให้เลือกปุ่มเอง

![หน้า Welcome to ego(lite) มีปุ่ม macOS, Windows (beta) และภาพตัวอย่างหน้าต่างติดตั้งที่บอกให้ดับเบิลคลิกไอคอน](images/02-download-page.png)

- **macOS**: หน้าเว็บตรวจชิปให้เอง (Intel หรือ Apple Silicon) ตาม FAQ ของหน้านี้
- **Windows (beta)**: มีคู่มือแยกที่ `/document/en/docs/windows/quick-start`
- Mac รุ่นเก่ามาก: ปุ่มสามจุดมีลิงก์ "On a super old Mac? Download 0.4.7.4"

รอบนี้เราให้ ego-browser กดปุ่ม macOS เอง แล้วจับ event ดาวน์โหลด ได้ผลจริงแบบนี้:

```
{ url: 'https://cdn.ego.app/setup/macos/arm64/egolite.dmg?ref_code=<redacted>', suggestedFilename: 'egolite-….dmg' }
{ saved: 'egolite-….dmg', failure: null }
```

> URL ดาวน์โหลดพก `ref_code` ติดมาด้วย ถ้าจะแชร์ลิงก์หรือแคปจอ ให้ตัดส่วนนี้ออก

## 3. ตรวจไฟล์ก่อนติดตั้ง (ไม่ต้องรันอะไร)

ไฟล์ที่โหลดจากเน็ตควรตรวจก่อนเปิด คำสั่งชุดนี้แค่อ่าน DMG แบบ read-only ไม่ได้รันโปรแกรมข้างใน:

```
$ ls -lh egolite.dmg
143M egolite.dmg

$ shasum -a 256 egolite.dmg
3f4ae2584300736897af8987bc5eb17b1ebea2cb6fcee16eed1f90f95616317e  egolite.dmg

$ ls /tmp/egolite-mnt
ego lite.app

$ defaults read ".../Info.plist" CFBundleShortVersionString
0.6.2.5

$ codesign -dv --verbose=2 "ego lite.app" 2>&1 | grep -E "Identifier|Authority|TeamIdentifier|Timestamp"
Identifier=com.citrolabs.ego.lite
Authority=Developer ID Application: CITRO LABS PTE. LIMITED (JGQLC6YQYJ)
Authority=Developer ID Certification Authority
Authority=Apple Root CA
Timestamp=29 Oct BE 2569 at 19:49:15
TeamIdentifier=JGQLC6YQYJ

$ spctl -a -vv "ego lite.app"
/tmp/egolite-mnt/ego lite.app: accepted
source=Notarized Developer ID
origin=Developer ID Application: CITRO LABS PTE. LIMITED (JGQLC6YQYJ)
```

อ่านผลยังไง:
- `accepted` + `Notarized Developer ID` = Apple รับรองแล้ว Gatekeeper จะไม่บล็อก
- ผู้เซ็นคือ CITRO LABS (บริษัทที่ทำ ego) ทีม `JGQLC6YQYJ`
- ค่า SHA-256 ข้างบนเป็นของไฟล์วันที่ 30 ต.ค. ถ้าโหลดวันอื่น ค่าจะเปลี่ยนตามรุ่น

ไฟล์ดิบ: [`captures/08-dmg-inspect.txt`](captures/08-dmg-inspect.txt) (มีคำเตือนว่า `hdiutil attach` เลิกใช้แล้ว ให้ใช้ `diskutil image attach` แทน)

## 4. ติดตั้งและ onboarding

1. เปิด DMG
2. ดับเบิลคลิกไอคอน **ego lite** (ภาพตัวอย่างในหน้าดาวน์โหลดบอกด้วยว่า *Quit ego(lite) first if it's running*)
3. เปิด ego(lite) แล้วทำ onboarding ให้จบ

![หน้า Quick start ในเอกสาร ส่วน Install ego(lite): วิดีโอติดตั้ง 44 วินาที และภาพหน้าจอ ego(lite) หลัง onboarding](images/03-onboarding-doc.png)

ตอน onboarding ครั้งแรก ego(lite) จะ:
- สแกนหา agent ในเครื่อง แล้ว **เขียน skill `ego-browser`** ลง `~/.agents/skills` และ `~/.claude/skills/`
- ถามว่าจะ **นำเข้าข้อมูลจากเบราว์เซอร์เดิม** ไหม (session, bookmark, รหัสผ่าน, extension) ข้อมูลอยู่ในเครื่องเรา ไม่ขึ้นคลาวด์
- macOS อาจถามรหัส keychain **หลายครั้ง** ให้ใส่ทุกครั้ง นั่นคือสิ่งที่ทำให้ย้าย login state มาได้

> เครื่องที่เขียนคู่มือนี้ลง 0.6.1.13 อยู่แล้ว และ ego(lite) ตัวนั้นกำลังเป็นคนจับภาพคู่มือนี้อยู่ เราจึงไม่ได้กดติดตั้ง 0.6.2.5 ทับระหว่างทำ ภาพ onboarding ข้างบนมาจากเอกสารทางการ ไม่ใช่จากเครื่องนี้

## 5. ตรวจว่าเครื่องพร้อม

หลัง onboarding ลองสามคำสั่งนี้ใน Terminal:

```
$ ego-browser --version
ego-browser 0.6.1.13
  chromium 156.0.8078.48
  node v24.22.1

$ ls ~/.claude/skills/ego-browser
agents
assets
learnings
references
scripts
SKILL.md

$ ls ~/.agents/skills | grep ego
ego-browser

$ ego-browser skill | tail -1
[ego-browser:skill] end of guide v2.1.0
```

- `ego-browser --version` บอกรุ่นของ ego, Chromium และ Node ที่ฝังมา
- ถ้ามีโฟลเดอร์ `ego-browser` ใน skills แปลว่า onboarding เขียน skill ให้แล้ว
- `ego-browser skill` พิมพ์คู่มือที่ตรงกับรุ่นที่ลงอยู่ บรรทัดสุดท้ายต้องเป็น `end of guide` ถ้าไม่เห็นแปลว่าผลถูกตัด

คำสั่งทั้งหมดของ CLI ([`captures/02-help.txt`](captures/02-help.txt)):

```
$ ego-browser --help
Usage:
  ego-browser help [topic]
  ego-browser import list
  ego-browser import --browser <browser> [--profile <dir-name> ...]
  ego-browser skill
  ego-browser upgrade
  ego-browser nodejs -e <script>
  ego-browser nodejs < script.js
```

ข้าม import ตอน onboarding ไปแล้ว? ใช้ `ego-browser import --browser chrome --profile Default` ทีหลังได้

## 6. เชื่อมกับ Claude Code

![เอกสาร How to use ego(lite) with Claude Code: สารบัญ Use Code not Cowork, Step 1 enable Bypass permissions, Step 2 load the ego-browser skill](images/05-claude-code-doc.png)

ตามเอกสาร Claude Code ของ ego มีสามข้อที่ต้องถูก:

1. **ใช้ Code ไม่ใช่ Cowork** ใน Claude Desktop skill นี้ทำมาให้ Claude Code จึงไม่ขึ้นในเมนู Cowork
2. **เปิดสิทธิ์ให้รันคำสั่ง** Desktop: เลือก *Bypass permissions* ข้างช่องพิมพ์ · Terminal: `claude --dangerously-skip-permissions`
3. **ถ้า Claude เปิดอยู่ระหว่าง onboarding ให้ปิดแล้วเปิดใหม่** เพื่อให้รายการ skill โหลดใหม่

> **คำเตือน:** Bypass permissions ทำให้ agent รันคำสั่งอะไรก็ได้ในเครื่องโดยไม่ถามก่อน ใช้ในโฟลเดอร์งานที่แยกไว้ และอย่าเปิดทิ้งไว้ในโฟลเดอร์ที่มีของสำคัญ

แล้วพิมพ์ `/ego-browser` ตามด้วยงานในข้อความเดียวกัน หน้าตาตอนเรียก skill ใน Codex (ตัวอย่างในเอกสาร) เป็นแบบนี้:

![เอกสาร Connect your agent: พิมพ์ /ego ในช่องแชตของ Codex แล้วมีรายการ skill Ego Browser ขึ้นมา โหมด Full access](images/04-connect-agent.png)

## 7. งานแรก

![เอกสาร Run your first task: วิดีโอ 40 วินาที และ prompt ตัวอย่างให้เปิดบล็อก OpenAI กับ Anthropic แล้วสรุป](images/06-first-task.png)

prompt ตัวอย่างจากเอกสาร คัดลอกไปวางได้เลย:

```text
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.
```

agent จะสร้าง Space ใหม่ เปิดสองหน้า อ่านบทความล่าสุด แล้วส่งสรุปกลับมาในแชต

## 8. เขียนสคริปต์เองครั้งแรก (สิ่งที่ agent ทำอยู่เบื้องหลัง)

เวลา agent ใช้ skill นี้ มันเขียนสคริปต์ Node สั้น ๆ ส่งให้ `ego-browser nodejs` เราลองเองได้ ผลข้างล่างรันจริงทั้งหมด

**รอบที่ 1: เปิดหน้าแล้วขอ snapshot** ([`captures/05-first-script.txt`](captures/05-first-script.txt))

```
$ ego-browser nodejs <<'EOF'
const task = await taskSpace("tutorial: ego lite guide");
const page = task.page("p1");
await page.goto("https://example.com");
await page.waitForLoadState();
console.log({ taskSpaceId: task.spaceId, page: page.label, title: await page.title() });
console.log(await page.snapshot());
EOF
{ taskSpaceId: 9, page: 'p1', title: 'Example Domain' }
[p1 "Example Domain" | space "tutorial: ego lite guide"(9): 1 managed, 0 untracked — p1* "Example Domain"]
root
  svg_root
  paragraph
    text "This domain is for use in documentation examples without needing permission. …"
  …
  anchor [ref=131, loc=href:https://iana.org/help/example-domains, url=https://iana.org/help/example-domains]
    text "Learn more"
```

- `taskSpace(name)` สร้าง Space ใหม่ หรือกลับเข้า Space เดิมที่ชื่อนี้ (ได้หมายเลข 9)
- `snapshot()` ไม่ใช่ HTML ดิบ แต่เป็นต้นไม้ accessibility ที่มี `ref` ให้กดต่อได้

**รอบที่ 2: กดลิงก์แล้วจับภาพ** ([`captures/06-click-and-shot.txt`](captures/06-click-and-shot.txt))

```
$ ego-browser nodejs <<'EOF'
const task = await taskSpace("tutorial: ego lite guide");
const page = task.page("p1");
const receipt = await page.click("text=Learn more", { label: "open IANA help page" });
await page.waitForURL(/iana\.org/);
const path = await page.screenshot({ path: "<book>/images/11-iana-after-click.png" });
console.log({ url: await page.url(), title: await page.title(), screenshot: path.split("/").pop() });
console.log(await task.pages());
EOF
{ url: 'https://www.iana.org/help/example-domains', title: 'Example Domains', screenshot: '11-iana-after-click.png' }
[ Page { label: 'p1', spaceId: 9, mouse: PageMouse {}, keyboard: PageKeyboard {} } ]
```

ภาพที่สคริปต์นี้บันทึก (เปลี่ยนชื่อเป็นเลขลำดับของคู่มือทีหลัง):

![หน้า Example Domains ของ IANA ที่เปิดขึ้นหลังสคริปต์กดลิงก์ Learn more](images/09-first-script-result.png)

- `label` บนคำสั่ง click คือข้อความที่ขึ้นข้างเคอร์เซอร์ของ agent ให้คนดูรู้ว่ามันกำลังทำอะไร
- เวลาทั้งหมดในสคริปต์เป็น **มิลลิวินาที**
- ทุกครั้งที่รันคือ process ใหม่ ตัวแปรหายหมด แต่ Space และแท็บยังอยู่

## 9. ดูและรับช่วงต่อ: Space

กดปุ่ม Space มุมขวาบนของ ego(lite) จะเห็นทุก Space ตัวที่เรืองแสงสีฟ้าคือตัวที่ agent กำลังทำงาน กดเข้าไปดูหรือช่วยได้

![เอกสาร Watch and take over: แผง Space แสดง 2 space(s) ของ agent ที่ทำงานแยกจากแท็บของเรา](images/07-space-panel.png)

![เอกสาร Space: Space คือพื้นที่ทำงานคู่ขนานในเบราว์เซอร์ process เดียวกัน หนึ่ง BrowserContext ต่อหนึ่งงาน ไม่ใช่หน้าต่างใหม่ ไม่ใช่ headless ไม่ใช่คลาวด์](images/08-space-doc.png)

- เจอหน้าล็อกอินหรือ verification: agent เรียก `task.handOff()` แล้วบอกให้เรามาทำเอง
- **อย่าวางรหัสผ่านหรือรหัสยืนยันลงในแชต** ล็อกอินใน Space เอง แล้วบอก agent ให้ทำต่อ
- งานเสร็จ agent ปิด Space ด้วย `task.finish({ keep: [] })` รอบนี้ได้ผลจริง:

```
{"spaceId":9,"closedSpace":true,"keptManagedLabels":[],"closedManagedLabels":["p1"],"preservedUnmanagedCount":0}
```

## 10. แก้ปัญหา (จากเอกสาร Claude Code ของ ego)

- **`/ego-browser` ไม่ขึ้น**: เช็กว่าอยู่ในโหมด Code ไม่ใช่ Cowork ถ้า onboarding จบตอน Claude เปิดอยู่ ให้รีสตาร์ต Claude
- **ไม่มีตัวเลือก Bypass permissions**: Settings → Claude Code → Allow bypass permissions mode (ถ้าองค์กรล็อกไว้ ต้องถามแอดมิน)
- **โหลด skill ได้แต่ ego(lite) ไม่เปิด**: สิทธิ์ยังไม่ใช่ Bypass ปิด session แล้วเริ่มใหม่ด้วย `claude --dangerously-skip-permissions`
- **มี update**: ถ้าผลของคำสั่งมี `[ego-browser:notice]` ให้รัน `ego-browser upgrade` แล้วรัน `ego-browser skill` อีกรอบ

## 11. กับดักที่เจอจริงตอนทำคู่มือนี้

| เจออะไร | สาเหตุ | ทางแก้ |
|---|---|---|
| `page.click("loc=role:button[name='macOS']")` → `matched 0 elements` | ชื่อ accessible ของปุ่มคือ `Download for macOS` ไม่ใช่ข้อความ `macOS` ที่เห็น | `snapshot()` ก่อนทุกครั้ง แล้วใช้ selector ที่มันพิมพ์ให้: `button[aria-label="Download for macOS"]` |
| `window.scrollTo()` บนหน้าแรกไม่เลื่อน (`scrollY` ยังเป็น 0) | หน้าแรกใช้ตัวเลื่อนของตัวเอง | `element.scrollIntoView()` แทน |
| ภาพแรกเล็กมากถ้าไม่กำหนดขนาด | Space ใหม่มีหน้าต่างเล็ก | `page.cdp("Emulation.setDeviceMetricsOverride", { width: 1440, height: 1000, …, screenWidth, screenHeight })` |
| URL ดาวน์โหลดมี `ref_code` | ลิงก์อ้างอิงของผู้ผลิต | ตัดออกก่อนแชร์หรือแคปจอ |

เพิ่มเติม: เราลองเรียก `page.screenshot()` แบบไม่ใส่ path สองครั้งในรุ่น 0.6.1.13 ได้ชื่อไฟล์ต่างกัน (`…-1.png`, `…-2.png`, `samePath: false`) แต่ไฟล์อยู่ในโฟลเดอร์ชั่วคราว ใส่ path เต็มเสมอ ([`captures/07-evaluate-and-trap.txt`](captures/07-evaluate-and-trap.txt))

## 12. skill ในรีโปนี้ ใช้ได้ทั้ง Claude Code, omx และ omp

`ego-lite-install` เป็น skill **ประจำรีโปนี้** ไม่ได้ลงทั้งเครื่อง เปิด agent ในรีโปนี้แล้วมันเจอเอง: ตรวจ → โหลดและตรวจไฟล์ → คนกดติดตั้ง → ลิงก์ skill ego-browser ให้ทุก agent → พิสูจน์

| ที่อยู่ในรีโป | agent ที่อ่าน |
|---|---|
| [`.claude/skills/ego-lite-install/`](../../../../.claude/skills/ego-lite-install/) (ไฟล์จริง) | Claude Code, omp |
| `.agents/skills/ego-lite-install` → symlink ไปที่ข้างบน | Codex / omx, omp |
| `.codex/skills/ego-lite-install` → symlink ไปที่ข้างบน | Codex / omx (path เก่า) |

แล้วสั่งแต่ละ agent แบบ headless **จากโฟลเดอร์รีโป** ให้ใช้ skill นี้และรายงานผลตรวจ ([`captures/10-demo-*.txt`](captures/)):

| agent | คำสั่ง | คำตอบ |
|---|---|---|
| Claude Code | `claude -p "Use the ego-lite-install skill…" --allowedTools Bash` | `ego-browser 0.6.1.13` · `VERDICT: ready` |
| omx | `omx exec "Use the ego-lite-install skill…"` | `ego-browser 0.6.1.13` · `VERDICT: ready` |
| omp | `omp -p "Use the ego-lite-install skill…"` | `ego-browser 0.6.1.13` · `VERDICT: ready` |

ทั้งสามรันจากโฟลเดอร์รีโป หลังถอดสำเนา global ออกหมดแล้ว จึงพิสูจน์ว่า agent เจอ skill จากในรีโปเอง · รอบทดลองแรกในโฟลเดอร์นอก git omx ล้มด้วย `Not inside a trusted directory and --skip-git-repo-check was not specified.` ในรีโปไม่ต้องใส่ flag

## ภาคผนวก: ตัวเลขที่ผู้ผลิตอ้าง

ภาพสองภาพนี้มาจากหน้าแรกของ lite.ego.app เป็นข้อมูลของผู้ผลิต เราไม่ได้วัดซ้ำ

![หน้าแรกส่วน Faster runs, fewer failures, fewer tokens: เวลาเฉลี่ยต่องาน ego-browser 398s เทียบ chrome-devtools-cli 587s ถึง playwright-cli 648s](images/10-benchmark.png)

ตัวเลขบนหน้าเดียวกัน: อัตราสำเร็จ ego-browser 93.50% (ตัวถัดไป browser-harness 77.40%) และค่าใช้จ่ายเฉลี่ยต่องาน $1.64 (ตัวถัดไป browser-harness $2.43)

![หน้าแรกส่วน All the hard parts, already handled: ห้าหัวข้อ Any agent, logged in, own Space, iframes and shadow DOM, data stays yours](images/11-hard-parts.png)

---

— AIExpo Oracle (Oracle AI) · เก็บข้อมูลและเขียน 30 ต.ค. 2026 · ภาพหน้าเว็บเป็นของ Citro Labs (lite.ego.app)