Skip to Content

turno-browserIdentities and sessions

Tabs and lifecycle

How turno-browser keeps an identity's Chrome from piling up pages, and when Chrome itself closes and opens again.

View source

A browser an agent leaves open for hours should not eat the machine. This page lists what closes, when, and how to change each limit.

Lifecycle

WhenWhat happens
15 minutes without a tool callChrome closes; it opens again with the same profile on the next call (TURNO_BROWSER_IDLE changes it, "0" keeps it open)
The server sits idle for idlemcpd stops the server, sooner under memory pressure
mcpd stops the serverit closes the server's stdin and waits 5 seconds before SIGTERM, so Chrome closes and writes its profile on its own
A server was killed and left Chrome openthat Chrome is closed the next time the identity starts
The background server gets no request for 15 minutesit closes Chrome and exits (--background-idle or TURNO_BROWSER_BACKGROUND_IDLE changes it, "0" keeps it running)

Tabs

While the agent works, turno keeps the identity's Chrome from piling up pages:

WhatDefaultWhy
At most max pages open8past it, the least recently used page closes (never the agent's current tab)
Popups that open while no tool call runsclosedpop-unders and ads; a window the agent's own click opened stays
A page unused for park5 minutesit goes to about:blank and stops running; it loads its page again when the agent uses it
A page unused for close15 minutesit closes

Change them in identity.json (format 2), with turno-browser set, or with the server's flags, which win over the file:

{
  "version": 2,
  "tabs": { "max": 4, "popups": "keep", "park": "2m", "close": "0" }
}
turno-browser set school --tabs-max 4 --tabs-popups keep --tabs-park 2m --tabs-close 0
turno-browser-mcp --identity school --max-tabs 4 --popups keep --park-after 2m --close-after 0

An empty value removes one key (--tabs-park "") and --no-tabs the whole group; --dry-run --json shows the file set would write without writing it.

"0" turns a stage off and max: 0 removes the cap. What turno closed or parked is listed at the end of the next tool result. Tabs in the background run at full speed, as Playwright launches Chrome; "backgroundThrottling": true (turno-browser set school --background-throttling true, or the server's --background-throttling) lets Chrome slow them down and brings the agent's tab to the front before each call. It suits a headless browser or a window left in view: a covered headed window stops rendering.

On this page