快速解决 ego-browser 命令找不到：macOS PATH 配置完整指南

【免费下载链接】ego-lite The fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config. 项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite

macOS 终端出现 ego-browser 命令找不到时，多数是 ego lite 的 PATH 问题：命令在首次引导后才写入 ~/.local/bin，而当前 Shell 未包含该目录。按「分诊 → 修复 → 验证」处理，数条命令内可解决。

先查哪一环：一张分诊表定位 command not found

command not found 只是表象，两条命令即可把情况拆成四类：

command -v ego-browser
ls -l ~/.local/bin/ego-browser

第一行查询命令的注册路径，输出路径即命令可达；第二行检查可执行文件本身是否存在。对照下表：

终端现象	可能原因	处理动作
第一条命令输出路径	命令已在 PATH 上，故障在运行时层	直接跳到「端到端验证」小节
无输出，但第二条列出文件	PATH 缺少 ~/.local/bin	执行「zsh PATH 配置」小节
两条均无输出	首次引导未完成，或安装不完整	按「四类根因」逐节确认
应用首次启动被拦截，或安装脚本报错	Gatekeeper 拦截或安装损坏	系统设置中允许，或重跑安装脚本

四类根因：先确认，再开方

PATH 未含 ~/.local/bin：zsh PATH 配置

确认判据：上表第二条输出文件，而 command -v 无输出。临时注入仅对当前会话生效：

export PATH="$HOME/.local/bin:$PATH"
command -v ego-browser

预期：第二行输出形如 /Users/…/.local/bin/ego-browser 的绝对路径，说明命令已可达。永久生效需写入 ~/.zshrc（bash 用户改为 ~/.bash_profile）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

判据：新开终端后 command -v ego-browser 输出路径，即配置生效。

首次引导未完成：命令未被注册

确认判据：~/.local/bin/ego-browser 不存在。安装脚本只负责装好应用、移除隔离属性并拉起应用；命令注册到 ~/.local/bin 发生在应用内首次引导（Onboarding）环节，跳过该步骤，命令就从未被写入。

修复：重新打开 ego lite 应用并完成引导（可一并选择是否导入 Chrome 登录数据），再执行 command -v ego-browser，预期输出路径。

安装未完成或损坏：重跑官方安装脚本

确认判据：/Applications 与 ~/Applications 均无 ego lite.app，或应用首次启动被 Gatekeeper 拦截。被拦截时到「系统设置 → 隐私与安全性」中手动允许 ego lite；缺失时重跑官方脚本：

sh skills/ego-browser/scripts/install.sh

脚本仅支持 macOS，下载失败自动重试 3 次，已安装则跳过下载直接打开应用。本地没有仓库副本时，先克隆再执行：

git clone https://gitcode.com/GitHub_Trending/eg/ego-lite
cd ego-lite
sh skills/ego-browser

【免费下载链接】ego-lite The fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config. 项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite