Docs/Using Chervil

The everyday browser

The ordinary browser features Chervil has so it can be your only browser β€” zoom, downloads, printing, reader view, bookmarks & folders, private tabs, multiple windows, ad blocking, and setting Chervil as your default browser.

Chervil is AI-first, but it's also a real browser β€” it has the everyday furniture you expect, so you can make it your only one. This page is the quick reference.

Zoom

Zoom the current page or embedded site with Ctrl +, Ctrl βˆ’, and Ctrl 0 to reset. There's also a βˆ’ 100% + cluster in the toolbar (click the percentage to reset). Your zoom level is remembered between sessions. Don't need the cluster? Hide it in Settings β†’ General β†’ Toolbar buttons, or right-click the toolbar.

Downloads

Files you download from embedded sites save straight to your Downloads folder and appear in Library β†’ Downloads, with Open, Show in folder, and Remove. Removing an item only clears it from the list β€” it never deletes the file.

Print

Press Ctrl+P (or View β†’ Print… in the menu bar) to print the current page or site through your system's normal print dialog. There's an optional πŸ–¨ toolbar button too.

Reader view

On a live website, click the πŸ“– Reader button to strip the article down to clean, readable text β€” no ads or clutter. The reader page is a normal Chervil page, so you can go Back to the site, listen to it, export it, or bookmark it. It runs entirely on your machine (no model call, no cost).

Bookmarks, folders & the bookmarks bar

Bookmark the current page or site with the β˜† button. In Library β†’ Bookmarks you can organize bookmarks into folders (each row has a folder picker, and there's a + Folder button). Turn on the bookmarks bar under the address bar from Settings β†’ General, the toolbar right-click menu, or Ctrl+Shift+B β€” folders become dropdowns and loose bookmarks become one-click buttons.

The Library

The Library button (formerly "History") opens your History, Bookmarks, Sites, Downloads, and Trash β€” with a search box that filters whatever list you're viewing.

Address bar: search & suggestions

Type in the address bar and Chervil suggests matching sites from your history and bookmarks, plus quick Search the web and Ask Sprig actions β€” use the arrow keys and Enter to pick one.

By default a plain question goes to Sprig. To do a traditional web search instead, start with a bang:

  • g! β€” Google
  • ddg! β€” DuckDuckGo
  • b! β€” Bing
  • s! β€” your default engine (set it in Settings β†’ General β†’ Search)

For example, g! best hiking boots opens Google results.

Private tabs

Open a private tab with Ctrl+Shift+N or the tab right-click menu. Nothing in a private tab is saved to your history, Library, or living pages, and it isn't reopened after you restart. (Private tabs keep local traces out of your session; they aren't network-level anonymity.)

Multiple windows

Open another window with Ctrl+N, File β†’ New Window, or the tab right-click menu β€” handy across monitors. Extra windows are for browsing in the moment; your saved session lives in your main window.

Ad & tracker blocking

Turn on Block ads & trackers in Settings β†’ General β†’ Browsing & privacy to block common ad and tracking hosts on embedded sites. It shows a running count of what it blocked this session. It's off by default.

Clear browsing data

Settings β†’ General β†’ Browsing & privacy β†’ Clear… wipes cookies, cache, and site data for embedded sites, plus your Sites history and Downloads list. Your bookmarks and saved logins are kept.

Picture-in-picture & tab audio

Pop a playing video out of an embedded site into a floating window with the πŸ“Ί Picture-in-picture button. When a site is making sound, a πŸ”Š badge appears on its tab β€” click it to mute or unmute.

Make Chervil your default browser

In Settings β†’ General β†’ Browsing & privacy, click Make default…. Chervil registers as an http/https handler and opens your operating system's default-apps picker, where you confirm the choice (Windows and macOS don't let an app set itself). After that, links you click in other apps open in a Chervil tab.

Show the menu bar

The native File / Edit / View menu bar is hidden by default (press Alt to reveal it). To keep it visible, turn on Always show the menu bar in Settings β†’ Appearance.