How to use ego-lite: Let Codex and Claude Code share login session without grabbing browser tabs

ego-lite Installation and Usage Guide: Describes how to let Codex and Claude Code use independent Space to run browser tasks, and analyzes login session migration, privacy permissions, and Windows support limitations.

This tutorial by ego-lite focuses on the specific task in the title. Currently macOS is officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

Below is a demonstration using a test environment and revocable data. When accounts, keys, machine control, investments or emergency communications are involved, manual confirmation must be done.

The difference between ego-lite, regular Chrome and automated browsers

This section only deals with “the differences between ego-lite, regular Chrome and automated browsers”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
# 先阅读项目 README 与当前支持平台

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

How Space isolates the Agent tab

It is recommended to execute in the following order:

  1. Check the actual version and source.
  2. Use a test account, test directory, or test device.
  3. Perform an undoable action.
  4. Save the output, exit code, or screenshot.
  5. Revert the changes and re-verify.
1
# 为测试任务创建独立 Space

The completion criterion is that “How Space isolates Agent tabs” gets verifiable results, not that the command just doesn’t report an error.

What to check before installing ego-browser Skill

Check items Passing criteria Stop signal
What to check before installing ego-browser Skill Clear input, output and permission scope The tool automatically expands the scope of operations
Source Can return to the official warehouse or original data Rely on unknown mirrors or second-hand conclusions
Security No secret value in log Token, cookie or private data present
Recovery Ability to return to pre-execution state No backup or undo methods
1
ls ~/.codex/skills 2>/dev/null

When a stop signal appears, resume first and do not continue to the next step.

Only migrate one test Profile

This section only deals with “migrating only one test profile”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
ls ~/Library/Application\ Support/Google/Chrome 2>/dev/null

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

What are the risks of cookies, extensions and bookmarks?

It is recommended to execute in the following order:

  1. Check the actual version and source.
  2. Use a test account, test directory, or test device.
  3. Perform an undoable action.
  4. Save the output, exit code, or screenshot.
  5. Revert the changes and re-verify.
1
# 不迁移支付、管理后台或主邮箱会话

The completion standard is “what risks do cookies, extensions and bookmarks bring respectively” to obtain verifiable results, rather than the command just not reporting an error.

Give Codex a read-only web page task

Check items Passing criteria Stop signal
Give Codex a read-only web page task Input, output and permission scope are clear Tool automatically expands the scope of operation
Source Can return to the official warehouse or original data Rely on unknown mirrors or second-hand conclusions
Security No secret value in log Token, cookie or private data present
Recovery Ability to return to pre-execution state No backup or undo methods
1
# 示例:打开公开文档并提取版本号

When a stop signal appears, resume first and do not continue to the next step.

Verify that the Agent does not take over the user tab

This section only deals with “verifying that the agent has not taken over the user’s tab”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
# 同时观察日常 Chrome 与 ego-lite Space

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

How to re-authorize after the login session is invalid?

It is recommended to execute in the following order:

  1. Check the actual version and source.
  2. Use a test account, test directory, or test device.
  3. Perform an undoable action.
  4. Save the output, exit code, or screenshot.
  5. Revert the changes and re-verify.
1
# 删除测试 Space 后重新创建

The completion standard is “how to re-authorize after the login session is invalid” to obtain a verifiable result, rather than the command not reporting an error.

Where should the downloaded file go?

Check items Passing criteria Stop signal
Where the downloaded file should go Clear input, output and permission scope Tool automatically expands the scope of operation
Source Can return to the official warehouse or original data Rely on unknown mirrors or second-hand conclusions
Security No secret value in log Token, cookie or private data present
Recovery Ability to return to pre-execution state No backup or undo methods
1
find ~/Downloads -maxdepth 2 -type f -mtime -1 2>/dev/null

When a stop signal appears, resume first and do not continue to the next step.

Form submission boundaries in web tasks

This section only deals with “form submission boundaries in web tasks”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
# 提交前要求 Agent 停止并等待确认

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

Do not allow sensitive input to appear in browser logs

It is recommended to execute in the following order:

  1. Check the actual version and source.
  2. Use a test account, test directory, or test device.
  3. Perform an undoable action.
  4. Save the output, exit code, or screenshot.
  5. Revert the changes and re-verify.
1
# 检查任务日志并删除敏感副本

The completion standard is “no sensitive input appears in the browser log” to obtain verifiable results, rather than the command just not reporting an error.

Which process should be ended first when Space is stuck?

Check items Passing criteria Stop signal
Which process should be terminated first when Space is stuck Clear input, output and permission ranges The tool automatically expands the scope of operations
Source Can return to the official warehouse or original data Rely on unknown mirrors or second-hand conclusions
Security No secret value in log Token, cookie or private data present
Recovery Ability to return to pre-execution state No backup or undo methods
1
ps aux | grep -i ego

When a stop signal appears, resume first and do not continue to the next step.

What settings should be backed up before upgrading?

This section only deals with “which settings to back up before upgrading”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
# 只备份配置,不复制主浏览器凭据库

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

Windows users can now verify

It is recommended to execute in the following order:

  1. Check the actual version and source.
  2. Use a test account, test directory, or test device.
  3. Perform an undoable action.
  4. Save the output, exit code, or screenshot.
  5. Revert the changes and re-verify.
1
Get-Command codex, claude -ErrorAction SilentlyContinue

The completion standard is “verifications that Windows users can now do” to obtain verifiable results, rather than the command just not reporting an error.

A to-do list suitable for ego-lite

Check items Passing criteria Stop signal
Task list suitable for ego-lite Clear input, output and permission scope Tool automatically expands the scope of operations
Source Can return to the official warehouse or original data Rely on unknown mirrors or second-hand conclusions
Security No secret value in log Token, cookie or private data present
Recovery Ability to return to pre-execution state No backup or undo methods
1
# 公开资料采集、后台只读核对、重复网页测试

When a stop signal appears, resume first and do not continue to the next step.

Delete the test space and do a final review

This section only deals with “final review after deleting the test space”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
# 确认账号会话和下载文件均已清理

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

Which data in the main browser Profile will never be migrated

It is recommended to execute in the following order:

  1. Check the actual version and source.
  2. Use a test account, test directory, or test device.
  3. Perform an undoable action.
  4. Save the output, exit code, or screenshot.
  5. Revert the changes and re-verify.
1
# 支付、密码管理器、管理后台与主邮箱保持隔离

The completion criterion is “which data in the main browser profile will never be migrated” to obtain a verifiable result, rather than the command just not reporting an error.

How to avoid task grabbing when two Spaces are running at the same time

Check items Passing criteria Stop signal
How to avoid task grabbing when two Spaces are running at the same time Clear input, output and permission ranges Tools automatically expand the scope of operations
Source Can return to the official warehouse or original data Rely on unknown mirrors or second-hand conclusions
Security No secret value in log Token, cookie or private data present
Recovery Ability to return to pre-execution state No backup or undo methods
1
ps aux | grep -i ego

When a stop signal appears, resume first and do not continue to the next step.

Re-do the login verification after upgrading the browser

This section only deals with “re-doing login verification after upgrading the browser”. Save the current state first and then run the minimal test. Do not change multiple conditions at the same time.

1
# 使用测试账号检查 Cookie 与扩展

For ego-lite, this boundary must be combined when judging the results: macOS is currently officially supported, Windows and Linux should still be checked according to the project roadmap; migrating the browser login session will expand the range of accounts that the Agent can access.

If the results are not repeatable, record the version, input, and logs, then narrow the scope of the test.

ego-lite final check

  • The versions and sources used are documented.
  • Test input and formal data have been isolated.
  • Commands, configurations and actual output can correspond.
  • The failed path was actively tested at least once.
  • Keys, accounts and private data do not enter Git or logs.
  • There are clear actions for upgrading, stopping and resuming.

If you still can’t explain how the results are produced, keep ego-lite in the test environment without extending the permissions or replacing the existing stable process.