Démarrage rapide

Installez ego lite en cinq minutes et lancez votre première tâche navigateur depuis votre CLI d'agent.

Prérequis

• macOS 12.0 ou ultérieur
• L'une de ces CLI d'agent : Claude Code, OpenAI Codex, Cursor, Continue, Gemini CLI, Hermes Agent, OpenClaw, Opencode

Installation

Choisissez ce qui vous convient.

Télécharger l'installeur macOS

Double-cliquez pour installer. Au premier lancement, ego lite parcourt votre machine à la recherche des CLI d'agent installées et inscrit la skill ego-browser dans le répertoire de skills de chacune.

Installer en ligne de commande

Dans le terminal de n'importe quelle CLI d'agent :

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

La commande installe le navigateur ego lite et le helper ego-browser, puis enregistre la skill auprès de toutes les CLI d'agent présentes sur votre machine.

Au premier démarrage, ego lite vous pose une seule question : faut-il importer vos données de navigateur ? Sélectionnez ensuite le navigateur correspondant pour confirmer, et vos sessions, cookies, extensions et profil suivent, et vos agents peuvent les réutiliser directement.

Votre première tâche

Dans votre CLI d'agent, tapez / pour ouvrir le sélecteur de skills, choisissez /ego-browser, puis décrivez la tâche en langage naturel :

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

Une fois le contexte de la skill chargé, l'agent produit et exécute le code suivant :

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

await snapshotText()
// Le snapshot renvoie la page de profil de @ego_agent : une SPA avec des centaines de refs.
// Le bouton Follow a pour nom accessible « Follow @ego_agent ». Sur cette exécution, sa ref vaut @92.

await click('@92')
await wait(3)  // Trois secondes pour laisser X valider le follow et re-rendre la page

await snapshotText()
// Après le click, le label du même bouton passe de « Follow @ego_agent » à « Following @ego_agent ». La ref ne change pas.

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

Deux points méritent qu'on s'y arrête :

• L'agent agit sur la ref renvoyée par snapshotText() (@92), pas sur un sélecteur CSS. La ref reflète la façon dont une personne perçoit l'élément (le nom accessible du bouton est bien « Follow @ego_agent »), donc elle résiste à toutes les rotations de class names de X. Les refs sont attribuées à chaque snapshot ; le numéro que vous verrez en pratique ne correspondra pas à celui de l'exemple.
• L'agent utilise la session X importée depuis votre Chrome. Pas de re-login, pas de cookie collé, pas de parcours OAuth. Au premier snapshot, le bouton Follow est déjà cliquable parce que vous êtes déjà connecté.

Suivre le travail de l'agent

Une fois la tâche lancée, ouvrez ego lite et cliquez sur le panneau Space dans la barre latérale. Le Space actif est mis en évidence ; entrez dedans pour voir l'agent travailler en direct : navigation, scroll, snapshots, extraction de données.

En bas de la vue Space, deux boutons :

• Reprendre la main (Take over). Récupérez l'onglet courant et pilotez-le vous-même.
• Arrêter (Stop). Stoppe la tâche immédiatement.

Manipuler une page

click n'est qu'une des opérations basées sur les refs. fill, type, pressKey, hover, select fonctionnent de la même façon : un snapshot, on identifie la ref cible, on agit dessus. Voici un parcours de connexion :

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

await snapshotText()
// Le snapshot ressemble grosso modo à :
//   @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 vous avez importé vos données Chrome lors de l'onboarding et que ce site était déjà connecté côté Chrome, openOrReuseTab amène l'agent directement à la page authentifiée. Le snapshot renvoie alors le dashboard plutôt que le formulaire de connexion, et l'agent peut sauter l'étape de saisie.

Lancer plusieurs tâches en parallèle

Chaque Space est nommé par ce que vous passez à useOrCreateTaskSpace. Les noms différents ne se gênent pas, donc tout tourne en même temps :

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

# En parallèle, Codex dans un autre terminal
ego-browser nodejs <<'EOF'
await useOrCreateTaskSpace('qa-regression')
await openOrReuseTab('https://staging.example.com', { wait: true })
EOF

Pour aller plus loin

• ego-browser — la liste complète des helpers, le contexte js() côté page, l'accès CDP brut
• Space — cycle de vie et règles de nommage d'un Space
• Snapshot — les refs et le sélecteur loc=
• Tâches navigateur en pratique — un parcours complet de bout en bout