Space

Un Space est un espace de travail parallèle qu'ego lite réserve à un agent IA. L'agent y ouvre des pages, les lit, clique, remplit des formulaires et télécharge des fichiers pendant que vous continuez à travailler dans vos onglets. Les deux côtés partagent le même processus navigateur ego lite, mais aucun n'interrompt l'autre.

Ce qu'il est, ce qu'il n'est pas

Un Space, c'est :

• Un espace de travail parallèle dans le même processus navigateur ego lite.
• Un BrowserContext isolé par tâche, avec ses propres cookies et son propre storage.

Un Space, ce n'est pas :

• Pas une nouvelle fenêtre, ni un nouveau profil Chrome.
• Pas du Chrome headless, ni du rendu hors écran.
• Pas une session navigateur dans le cloud — toutes les données restent sur votre machine.

Pourquoi Space

Quand on veut faire piloter un vrai navigateur par un agent, la réponse habituelle est de lancer une instance Chromium dédiée par tâche (headless, ou avec copie du profil). Le user-data-dir de Chrome est normalement verrouillé à un seul processus, donc réutiliser vos vraies connexions sur plusieurs sessions revient soit à se disputer le verrou, soit à dupliquer le profil dans un dossier temporaire.

Space prend une autre voie : toutes les tâches d'agent partagent le processus principal d'ego lite, chacune avec son propre BrowserContext natif pour cookies et storage, tout en réutilisant l'infrastructure du navigateur et vos sessions existantes.

Un test en parallèle de six sessions qui ouvrent uniquement about:blank :

Approche	Mémoire ajoutée	Processus ajoutés	Démarrage concurrent
Instances séparées + copie de profil	env. 15 Go	env. 84	env. 2,5 s
Space ego lite	env. 0,9 Go	env. 6	env. 0,6 s

Les chiffres sont là pour illustrer le modèle de ressources, pas pour servir de benchmark précis. Les coûts réels varient avec la complexité de la page, les extensions, les scripts du site et le nombre de tâches concurrentes.

Ce qui a sa place dans un Space

Utilisez un Space dès que vous avez besoin d'un vrai navigateur, d'une vraie session, ou de fichiers :

• Dashboards connectés, espaces personnels, pages de commandes, documents privés.
• Tout ce qui demande de cliquer, taper, paginer, filtrer, uploader, télécharger.
• Réutiliser les sessions déjà présentes dans ego lite plutôt que de se reconnecter à chaque fois.
• Les tâches qu'il faut pouvoir auditer ensuite — quelles pages, quelles actions.

Pour de l'information purement publique, une recherche web classique reste plus légère.

Comment vous et l'agent travaillez ensemble

Pendant qu'il travaille dans son Space, l'agent ne vole ni votre page courante, ni votre souris, ni le focus. Vous continuez à naviguer, et vous pouvez basculer dans un Space à tout moment pour suivre l'avancée.

Un déroulé type :

1. Vous décrivez une tâche web dans Codex, Claude Code, Cursor ou un autre agent.
2. L'agent utilise ego-browser pour écrire du code qui pilote le navigateur et ouvre le site cible dans un Space.
3. L'agent lit un Snapshot et agit dessus.
4. Sur les étapes qui exigent votre intervention — captcha, login par QR-code, confirmation de paiement — l'agent s'arrête et vous laisse prendre la main.
5. Une fois la main rendue, l'agent reprend.
6. La tâche terminée, les onglets restent dans le Space pour vous permettre de relire ce qui a été fait.

Sessions connectées

Pour les sites où vous êtes déjà connecté dans ego lite, l'agent arrive normalement directement sur la page authentifiée, sans avoir à réimporter de cookie.

L'agent devrait s'arrêter et vous rendre la main dans des cas comme :

• Codes SMS ou e-mail, login par QR code, clés de sécurité matérielles.
• Paiement, commande, virement, remboursement.
• Publication, suppression, archivage, ou toute modification en masse difficile à annuler.
• Autorisation d'une application tierce à accéder à votre compte.

Vous pouvez aussi poser les limites dès le départ, par exemple « lecture seule, sans modification » ou « arrêt avant l'envoi pour confirmation ».

Plusieurs tâches en parallèle

Un Space peut accueillir plusieurs tâches simultanées, chacune avec ses onglets, ses cookies et son storage. useOrCreateTaskSpace(name) réutilise ou crée un espace selon le nom, et la suite du script tourne à l'intérieur :

ego-browser nodejs <<'EOF'
const task = await useOrCreateTaskSpace('describe your task')

await openOrReuseTab('https://example.com', { wait: true, timeout: 20 })

cliLog(await snapshotText())

await click('button.primary', { label: 'click the submit button' })
EOF

Les refs de page ne sont pas partagées entre tâches. Après une navigation, un envoi de formulaire, un changement d'onglet ou un re-render dynamique, reprenez un snapshot — voir Snapshot.

Installation et activation

Livré avec ego lite — voir Démarrage rapide.

Si vous utilisez déjà un agent compatible Skills, vous pouvez installer la skill seule :

npx skills add github:CitroLabs/ego-lite/skills/ego-browser

Questions fréquentes

Un Space peut-il perturber ma page actuelle ?

Non. L'agent travaille dans le Space ; vos onglets, votre focus et votre souris ne sont pas affectés.

Les onglets se referment-ils en fin de tâche ?

Non. Le Space conserve les onglets, pour que vous puissiez revoir ce que l'agent a fait.

Quand n'a-t-on pas besoin d'un Space ?

Pour une simple recherche d'informations publiques ou un résumé de page publique — sans login ni interaction — une recherche web standard suffit.