Inicio rápido

Instala ego lite en cinco minutos y ejecuta tu primera tarea de navegador desde tu Agent CLI.

Requisitos del sistema

• macOS 12.0 o superior
• Alguno de estos Agent CLI: Claude Code, OpenAI Codex, Cursor, Continue, Gemini CLI, Hermes Agent, OpenClaw, Opencode

Instalación

Elige la opción que te acomode.

Descargar el instalador macOS

Doble clic para instalar. En el primer arranque, ego lite revisa tu equipo en busca de Agent CLI instalados y escribe el skill ego-browser en el directorio de skills de cada uno.

Instalar desde la línea de comandos

En la terminal de cualquier Agent CLI:

curl -fsSL https://lite.ego.app/install.sh | sh

El comando instala el navegador ego lite y el helper ego-browser, y registra el skill en todos los Agent CLI que existan en tu equipo.

La primera vez que ego lite arranca te hace una sola pregunta: ¿quieres importar los datos de tu navegador? Luego selecciona el navegador correspondiente para confirmar, e inicios de sesión, cookies, extensiones y Profile vienen contigo, y los agentes los pueden reutilizar de inmediato.

Tu primera tarea

En tu Agent CLI, escribe / para abrir el selector de skills, elige /ego-browser y describe la tarea en lenguaje natural:

/ego-browser follow @ego_agent on x.com for me

Tras cargar el contexto del skill, el agente genera y ejecuta el siguiente código:

ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('follow-ego-agent')
await openOrReuseTab('https://x.com/ego_agent', { wait: true })

await snapshotText()
// El snapshot devuelve la página de perfil de @ego_agent: una SPA con cientos de refs.
// El botón Follow tiene accessible name "Follow @ego_agent". En esta ejecución, su ref es @92.

await click('@92')
await wait(3)  // Tres segundos para que X confirme el follow y vuelva a renderizar

await snapshotText()
// Después del click, el label del mismo botón pasa de "Follow @ego_agent" a "Following @ego_agent". La ref no cambia.

cliLog('Done. @ego_agent followed.')
EOF

Dos detalles vale la pena destacar:

• El agente actúa sobre la ref que devolvió snapshotText() (@92), no sobre un selector CSS. La ref refleja cómo una persona percibe el elemento (el accessible name del botón es realmente "Follow @ego_agent"), así que sobrevive a cualquier rotación de class name que haga X. Las refs se asignan por snapshot, así que el número que veas en la práctica no va a coincidir con el del ejemplo.
• El agente usa el login de X que importaste desde Chrome. No hay que volver a iniciar sesión, ni pegar cookies, ni pasar por OAuth. En el primer snapshot, el botón Follow ya está en estado clicable porque ya estás dentro.

Mirar al agente trabajar

Cuando arranca la tarea, abre ego lite y haz clic en el panel Space de la barra lateral. El Space en ejecución queda resaltado; entra en él para ver al agente operar en tiempo real: navegación, scroll, snapshots, extracción de datos.

Al pie de la vista Space hay dos botones:

• Tomar control (Take over). Te llevas la pestaña actual del agente y la operas tú.
• Detener (Stop). Termina la tarea de inmediato.

Operar una página

click es solo una de las operaciones por ref. fill, type, pressKey, hover y select se usan igual: un snapshot, eliges la ref objetivo y actúas sobre ella. Aquí un flujo de login:

ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('example-login')
await openOrReuseTab('https://example.com/login', { wait: true })

await snapshotText()
// El snapshot devuelve algo así:
//   @3 [input type="email"]    placeholder="Email"
//   @4 [input type="password"] placeholder="Password"
//   @5 [button type="submit"]  "Continue"

await fill('@3', 'user@example.com')
await fill('@4', 'your-password')
await click('@5')
await waitForLoad()

const tab = await currentTab()
cliLog('Logged in:', tab.url)
EOF

Si durante el onboarding importaste los datos de Chrome y Chrome ya tenía sesión iniciada en este sitio, openOrReuseTab lleva al agente directo a la página autenticada. El snapshot vuelve con el dashboard en lugar del formulario, y el agente se ahorra el llenado.

Varias tareas en paralelo

Cada Space lleva el nombre que pasaste a useOrCreateTaskSpace. Nombres distintos no chocan entre sí, así que pueden correr al mismo tiempo:

# Claude Code en una terminal
ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('leads-enrichment')
await openOrReuseTab('https://www.linkedin.com', { wait: true })
EOF

# En paralelo, Codex en otra terminal
ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('qa-regression')
await openOrReuseTab('https://staging.example.com', { wait: true })
EOF

Siguientes pasos

• ego-browser: lista completa de helpers, contexto js() del lado de la página, acceso CDP en crudo
• Space: ciclo de vida y nomenclatura de un Space
• Snapshot: refs y el selector loc=
• Tareas de navegador en la práctica: un recorrido completo de extremo a extremo