Browser Management

Antigravity cung cấp các tính năng quản lý browser để Agent có thể tương tác với web một cách an toàn.

Chrome Extension

Antigravity Chrome Extension là bắt buộc để Agent có thể access browser.

Chức năng

• Cho phép Agent điều khiển browser
• Cho phép cancel browser tasks
• Cho phép chuyển focus về Antigravity

Cài đặt

Cách 1: Qua Chrome Web Store

• Được prompt tự động khi cần
• Click “Add to Chrome”

Cách 2: Thủ công

• Click Chrome icon trong Editor hoặc Manager
• Làm theo hướng dẫn

Verify Installation

1. Mở Chrome Extensions (chrome://extensions)
2. Tìm “Antigravity”
3. Ensure extension is enabled

Separate Chrome Profile

Antigravity sử dụng Chrome profile riêng biệt để:

• Isolate browsing sessions
• Không share cookies với profile thường
• Persist sign-ins trong profile này

Đặc điểm

Aspect	Profile thường	Antigravity Profile
Cookies	Shared	Isolated
Sign-ins	Personal	Agent-specific
History	Mixed	Agent sessions only
Extensions	Your extensions	Antigravity only

Nhận biết

• Hiển thị như dock icon riêng
• Profile name: “Antigravity”
• Có thể thấy trong Chrome profile switcher

Storage Location

Có thể thay đổi nơi lưu profile trong Settings:

• Default: ~/.antigravity/chrome-profile
• Custom: Set trong Settings > Browser

Allowlist / Denylist

Hệ thống bảo mật 2 lớp cho browser access.

Denylist (Server-side)

• Sử dụng Google’s BadUrlsChecker
• Enforce server-side - không thể bypass
• Block:
  • Phishing sites
  • Malware sources
  • Known dangerous URLs

Allowlist (Local)

File text local bạn kiểm soát:

~/.antigravity/allowlist.txt

localhost
127.0.0.1
*.myapp.com
staging.example.com

Mặc định

Allowlist ban đầu chỉ có:

localhost

Thêm vào Allowlist

Cách 1: Khi được prompt

Agent wants to access: https://api.example.com

[Allow Once] [Always Allow] [Deny]

• “Always Allow” → Thêm vào allowlist
• “Allow Once” → Cho phép lần này
• “Deny” → Block

Cách 2: Edit trực tiếp

echo "api.example.com" >> ~/.antigravity/allowlist.txt

Wildcards

*.example.com      # All subdomains
api.*.example.com  # Specific pattern

Priority

Denylist luôn được ưu tiên hơn Allowlist

Nếu URL nằm trong cả hai, nó sẽ bị block.

Best Practices

🔐 Security

• Minimal allowlist - Chỉ thêm URLs cần thiết
• Review định kỳ - Remove URLs không dùng
• Không trust wildcard rộng - *.* là nguy hiểm

⚡ Performance

• Profile riêng giúp clean chrome state
• Ít extensions → faster browser operations
• Clear profile periodically để giữ lean

🐛 Troubleshooting

Extension không hoạt động:

1. Check extension enabled
2. Reload extension
3. Restart Chrome
4. Reinstall extension

Profile issues:

1. Close all Chrome windows
2. Delete profile folder
3. Restart Antigravity (recreates profile)

URL blocked unexpectedly:

1. Check denylist (server-side)
2. Contact support nếu false positive
3. Use alternative URL nếu có

Privacy

• Profile riêng = browsing history isolated
• Sign-ins trong Antigravity profile không ảnh hưởng profile thường
• Có thể delete profile để clear all data