# Lilo Docs

> Learn Lilo, the fast, private macOS browser built on WebKit: install it, import your browser, organize tabs in Spaces and connect your AI agents.

Lilo is a free, open-source macOS browser built on the system's WebKit, with Spaces, split view, Chrome extensions and a built-in MCP server that lets AI agents drive real tabs. Install it with `brew install --cask alexays/tap/lilo` or the DMG from GitHub releases. For the product overview, pricing and requirements, read https://getlilo.app/llms.txt.

## Docs

- [Lilo documentation](https://docs.getlilo.app/): Learn Lilo, the macOS browser built on WebKit, by what you want to do, from installing it and importing your browser to connecting your AI agents.

## Get started

- [Install Lilo](https://docs.getlilo.app/start/install): Download Lilo or install it with Homebrew, check which macOS version it needs, and see how updates arrive on their own once it is installed.
- [Import from another browser](https://docs.getlilo.app/start/import): Bring your bookmarks, open tabs, history, sign-ins and extensions from Safari, Chrome, Arc, Firefox and other browsers into Lilo, step by step.
- [Your first five minutes](https://docs.getlilo.app/start/first-five-minutes): Take a short tour of Lilo after installing it: the sidebar, Spaces, the command bar and the few shortcuts that make everyday browsing faster.

## Guides

- [Spaces and profiles](https://docs.getlilo.app/guides/spaces-and-profiles): Separate work and personal browsing with Spaces, give each one its own profile and sign-ins, and switch between them from the sidebar or the keyboard.
- [Tabs and folders](https://docs.getlilo.app/guides/tabs-and-folders): Pin, group and archive tabs in the sidebar, organize them into folders, lock a folder, and choose how long unused tabs stay open in Lilo.
- [Command bar](https://docs.getlilo.app/guides/command-bar): Open pages, search your tabs, history and bookmarks, and run any Lilo command from one place with the command bar, without leaving the keyboard.
- [Split view](https://docs.getlilo.app/guides/split-view): Show up to four pages side by side in one window with split view, rearrange and resize the panes, and turn a split back into separate tabs.
- [Peek and Little window](https://docs.getlilo.app/guides/peek-and-little-window): Preview a link in Peek without leaving the page you are on, open quick links in a Little window, and choose which links open where in Lilo.
- [Extensions](https://docs.getlilo.app/guides/extensions): Install Chrome Web Store extensions in Lilo, manage their permissions and site access, keep them updated, and set up the password manager you already use.
- [Privacy controls](https://docs.getlilo.app/guides/privacy-controls): Block ads and trackers, decide what each site may use, browse in a Private Space, and review the privacy settings Lilo offers on your Mac.
- [Reading and media](https://docs.getlilo.app/guides/reading-and-media): Read articles in Reader, translate a page, find text on it, watch video picture in picture, take screenshots and share tabs from Lilo.
- [Downloads, history and bookmarks](https://docs.getlilo.app/guides/downloads-history-bookmarks): Find and manage your downloads, search and clear your browsing history, and save and organize your bookmarks in Lilo on your Mac.
- [Terminal tabs](https://docs.getlilo.app/guides/terminal): Open a terminal tab beside your pages, review a repository's changes, set the terminal's theme and font, and keep your Mac awake while commands run.
- [AI agents](https://docs.getlilo.app/guides/ai-agents): Connect Claude Code, Claude Desktop, Codex, Cursor or any MCP client to Lilo, let agents browse in a Space of their own, and approve what they do.
- [Customize Lilo](https://docs.getlilo.app/guides/customize): Change Lilo's appearance and sidebar, pick a keyboard shortcut preset or record your own shortcuts, and make the browser fit the way you work.
- [Automation](https://docs.getlilo.app/guides/automation): Script Lilo's windows and tabs with AppleScript, and use its Shortcuts actions to open pages, get the current tab or switch Space with a Focus.
- [Troubleshooting](https://docs.getlilo.app/guides/troubleshooting): Fix a page that misbehaves or freezes, an extension that fails, an incomplete import, a missing update or an agent that cannot connect.

## Reference

- [Keyboard shortcuts](https://docs.getlilo.app/reference/keyboard-shortcuts): Every keyboard shortcut in Lilo with its default keys, grouped by menu and generated from the app's own shortcut table so it stays accurate.
- [Settings](https://docs.getlilo.app/reference/settings): The rows of Lilo's Settings, section by section, with what each one does and the default of each switch, generated from the app's own settings model.
- [MCP tools](https://docs.getlilo.app/reference/mcp-tools): The tools Lilo's built-in MCP server gives AI agents, with each tool's parameters, types and required fields, generated from the app's definitions.
- [Import sources](https://docs.getlilo.app/reference/import-sources): Which browsers Lilo can import from and what comes along from each one: bookmarks, open tabs, history, sign-ins and extensions, never passwords.
- [Extension compatibility](https://docs.getlilo.app/reference/extension-compatibility): Which Chrome extension APIs Lilo supports, which ones behave differently from Chrome, and what that means for the extensions you rely on.
- [Web compatibility](https://docs.getlilo.app/reference/web-compatibility): The web platform features that work differently in Lilo than in other browsers, and the known limitations to keep in mind when a site misbehaves.

## About

- [Why WebKit](https://docs.getlilo.app/about/why-webkit): Why Lilo runs on the WebKit engine that ships with macOS instead of Chromium, what that costs in compatibility, and how its optional WebKit fork stays safe.
- [Privacy](https://docs.getlilo.app/about/privacy): What Lilo does and does not collect, every request it makes on its own and how to turn it off, and where your data is stored. No account, no telemetry.
- [Energy use](https://docs.getlilo.app/about/energy): How much power Lilo drew next to Safari, Chrome and Firefox in a measured run, how it was measured, and how Lilo keeps idle background tabs from using energy.
- [Agent safety](https://docs.getlilo.app/about/agent-safety): What an AI agent can do in Lilo without asking, what needs your approval, how agents stay apart from your tabs and Private Spaces, and the limits.

## Français

### Docs

- [Documentation de Lilo](https://docs.getlilo.app/fr): Apprenez Lilo, le navigateur macOS bâti sur WebKit, selon ce que vous voulez faire, de l'installation et l'import à la connexion de vos agents IA.

### Premiers pas

- [Installer Lilo](https://docs.getlilo.app/fr/start/install): Téléchargez Lilo ou installez-le avec Homebrew, vérifiez la version de macOS requise et voyez comment les mises à jour arrivent toutes seules.
- [Importer depuis un autre navigateur](https://docs.getlilo.app/fr/start/import): Apportez vos favoris, onglets ouverts, historique, connexions et extensions depuis Safari, Chrome, Arc, Firefox et d'autres navigateurs dans Lilo, pas à pas.
- [Vos cinq premières minutes](https://docs.getlilo.app/fr/start/first-five-minutes): Un court tour de Lilo après l'installation : la barre latérale, les espaces, la barre de commandes et les quelques raccourcis qui accélèrent la navigation.

### Guides

- [Espaces et profils](https://docs.getlilo.app/fr/guides/spaces-and-profiles): Séparez travail et vie personnelle avec les espaces, donnez à chacun son profil et ses connexions, et passez de l'un à l'autre à la souris ou au clavier.
- [Onglets et dossiers](https://docs.getlilo.app/fr/guides/tabs-and-folders): Épinglez, regroupez et archivez les onglets de la barre latérale, rangez-les en dossiers, verrouillez-en un et fixez la durée des onglets inutilisés dans Lilo.
- [Barre de commandes](https://docs.getlilo.app/fr/guides/command-bar): Ouvrez des pages, cherchez dans vos onglets, votre historique et vos favoris, et lancez toute commande de Lilo depuis la barre de commandes, au clavier.
- [Vue partagée](https://docs.getlilo.app/fr/guides/split-view): Affichez jusqu'à quatre pages côte à côte dans une même fenêtre avec la vue partagée, réorganisez et redimensionnez les volets, puis séparez-les en onglets.
- [Aperçu et petite fenêtre](https://docs.getlilo.app/fr/guides/peek-and-little-window): Prévisualisez un lien dans l'Aperçu sans quitter la page, ouvrez un lien rapide dans une petite fenêtre et choisissez où chaque lien s'ouvre dans Lilo.
- [Extensions](https://docs.getlilo.app/fr/guides/extensions): Installez des extensions du Chrome Web Store, gérez autorisations et accès aux sites, mettez-les à jour et ajoutez votre gestionnaire de mots de passe.
- [Contrôles de confidentialité](https://docs.getlilo.app/fr/guides/privacy-controls): Bloquez pubs et traqueurs, décidez de ce que chaque site peut utiliser, naviguez dans un espace privé et passez en revue les réglages de confidentialité.
- [Lecture et médias](https://docs.getlilo.app/fr/guides/reading-and-media): Lisez en Mode lecture, traduisez une page, cherchez-y du texte, regardez une vidéo en image dans l'image, faites des captures et partagez des onglets.
- [Téléchargements, historique et favoris](https://docs.getlilo.app/fr/guides/downloads-history-bookmarks): Retrouvez et gérez vos téléchargements, cherchez dans votre historique ou effacez-le, et enregistrez et rangez vos favoris dans Lilo sur votre Mac.
- [Onglets terminal](https://docs.getlilo.app/fr/guides/terminal): Ouvrez un onglet terminal à côté de vos pages, examinez les modifications d'un dépôt, réglez thème et police, et gardez le Mac éveillé pendant les commandes.
- [Agents IA](https://docs.getlilo.app/fr/guides/ai-agents): Connectez Claude Code, Claude Desktop, Codex, Cursor ou tout client MCP à Lilo, laissez les agents naviguer dans leur propre espace et approuvez ce qu'ils font.
- [Personnaliser Lilo](https://docs.getlilo.app/fr/guides/customize): Modifiez l'apparence et la barre latérale de Lilo, choisissez un jeu de raccourcis clavier ou enregistrez les vôtres, et adaptez le navigateur à vos habitudes.
- [Automatisation](https://docs.getlilo.app/fr/guides/automation): Pilotez les fenêtres et onglets de Lilo avec AppleScript, et ouvrez des pages, lisez l'onglet actuel ou changez d'espace avec ses actions Raccourcis.
- [Dépannage](https://docs.getlilo.app/fr/guides/troubleshooting): Corrigez une page qui se comporte mal ou se fige, une extension qui échoue, un import incomplet, une mise à jour manquante ou un agent qui ne se connecte pas.

### Référence

- [Raccourcis clavier](https://docs.getlilo.app/fr/reference/keyboard-shortcuts): Tous les raccourcis clavier de Lilo avec leurs touches par défaut, classés par menu et générés depuis la table de raccourcis de l'app pour rester exacts.
- [Réglages](https://docs.getlilo.app/fr/reference/settings): Les lignes des Réglages de Lilo, section par section, avec le rôle de chacune et la valeur par défaut de chaque interrupteur, tirées du modèle de l'app.
- [Outils MCP](https://docs.getlilo.app/fr/reference/mcp-tools): Les outils que le serveur MCP intégré de Lilo offre aux agents IA, avec leurs paramètres, types et champs requis, générés depuis les définitions de l'app.
- [Sources d'import](https://docs.getlilo.app/fr/reference/import-sources): Les navigateurs depuis lesquels Lilo importe et ce qui vient de chacun : favoris, onglets ouverts, historique, connexions, extensions, jamais les mots de passe.
- [Compatibilité des extensions](https://docs.getlilo.app/fr/reference/extension-compatibility): Les API d'extension Chrome que Lilo prend en charge, celles qui se comportent autrement que dans Chrome, et ce que cela change pour vos extensions.
- [Compatibilité web](https://docs.getlilo.app/fr/reference/web-compatibility): Les fonctions web qui marchent autrement dans Lilo que dans d'autres navigateurs, et les limites connues à garder en tête quand un site se comporte mal.

### À propos

- [Pourquoi WebKit](https://docs.getlilo.app/fr/about/why-webkit): Pourquoi Lilo repose sur le WebKit de macOS plutôt que sur Chromium, ce que cela coûte en compatibilité, et comment son fork optionnel de WebKit reste sûr.
- [Confidentialité](https://docs.getlilo.app/fr/about/privacy): Ce que Lilo collecte ou non, chaque requête qu'il envoie de lui-même et comment la couper, et où vos données sont rangées. Sans compte, sans télémétrie.
- [Consommation d'énergie](https://docs.getlilo.app/fr/about/energy): La puissance consommée par Lilo face à Safari, Chrome et Firefox lors d'une mesure, la méthode, et comment Lilo évite que les onglets inactifs consomment.
- [Sécurité des agents](https://docs.getlilo.app/fr/about/agent-safety): Ce qu'un agent IA peut faire dans Lilo sans demander, ce qui requiert votre accord, comment il reste à l'écart de vos onglets et espaces privés, et les limites.

## Agent skills

- [lilo-docs](https://docs.getlilo.app/.well-known/agent-skills/lilo-docs/SKILL.md): Read the Lilo Docs instead of answering from memory. Learn Lilo, the fast, private macOS browser built on WebKit: install it, import your browser, organize tabs in Spaces and connect your AI agents. Use when a task involves Lilo Docs: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://docs.getlilo.app/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.getlilo.app/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.getlilo.app/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.getlilo.app/openapi.json.
- [Agent skills](https://docs.getlilo.app/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://docs.getlilo.app/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.getlilo.app/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.getlilo.app/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.getlilo.app/sitemap.xml): Every indexable page URL with its last-modified date.