turno 0.3.0
A browser your agents can sign in with and carry between machines, clearer output for scripts, and diagnostics that say what to do next.
- Released
- Packages
- turno-cli0.3.0GitHub releaseChangelog
- turno-browser0.3.0GitHub releaseChangelog
- turno-core0.1.0GitHub releaseChangelog
- turno-fonts0.1.2GitHub releaseChangelog
turno 0.3.0 is mostly about the browser. turno-browser is now its own MCP server: it signs in to a site without showing the password to the model, moves a signed-in session to another machine, keeps tabs under control, and tells the agent what blocks a click. The CLI gets a stable output contract for scripts, diagnostics you can paste into an issue, and a safe mode. turno also has a home now: turno.wimo.dev.
Upgrade
One command
turno upgradeUpdates turno with the tool that installed it (npm, pnpm, yarn, bun, Volta, Homebrew or a git checkout), then rewrites the launchers.
Or with your package manager
npm install --global turno-cli@latestThen run turno upgrade --finish: it rewrites the launchers, checks the config and shows what changed.
Highlights
Browser
Sign in without showing the password
Each browser identity can keep its credentials in the OS secret store, and the new browser_login tool fills the site's sign-in form with them. The model never sees the values: they are bound to the site's own origins, redacted from every later result, and script tools are locked on a page that holds them. Submitting stays the agent's click unless the identity opts in.
turno browser vault add school campus \
--url https://campus.example.edu/login \
--username me --totp
turno browser vault list schoolBrowser
Take a signed-in browser to another machine
The file holds the identity's cookies, localStorage and IndexedDB, encrypted with a passphrase (scrypt and AES-256-GCM). It expires after 7 days by default and never holds vault credentials. With "keychain": "system" in identity.json, Chrome also encrypts the cookies on disk with the OS keychain, so a copy of the folder does not carry the sessions.
turno browser export school \
--out school.turno-session
turno browser import school.turno-session \
--as schoolBrowser
Tabs that clean up after themselves
An agent that browses for an hour used to leave dozens of tabs behind. Now each session keeps at most 8 pages; past that the least recently used one closes, never the agent's current tab. Pop-unders that open while no tool call runs are closed. A tab unused for 5 minutes is parked on a blank page and stops using CPU; the next call that needs it loads it again, and after 15 minutes it closes. Every result says what was closed or parked.
turno browser set school \
--tabs-max 12 --tabs-park 10mBrowser
Fewer round trips, and errors that say what is in the way
browser_batch runs up to 20 browser actions in one call: it checks every action first, stops at the first failure, and returns one line per action. A click that times out now says which element covers the target, or that the target is hidden, disabled, read-only or gone, and what to try next. settle in identity.json sets the wait after each action: in a local benchmark of 8 calls, "100ms" cut a form fill from about 1.8 s to 0.6 s.
Browser
Lighter pages
Two opt-in settings per identity, both off by default: block drops trackers, images, media or fonts you name, and cache keeps images, fonts, stylesheets and scripts on disk for that identity only, following Cache-Control and never storing anything tied to a cookie or an Authorization header.
turno browser set research \
--block-trackers true \
--block-types image,media --cacheCLI
Output for scripts
Every --json object now carries schemaVersion, --json=fields lists a command's fields and --json=a,b keeps only those. Errors under --json are one JSON line on stderr. Exit codes are documented and fixed: 0 ok, 1 failure, 2 usage, 3 no profile for the folder, 4 not signed in, 5 mcpd down.
CLI
Diagnostics and safe mode
Safe mode (--no-gateway or TURNO_SAFE=1) opens the agent with the profile's account but without the gateway, its token, the status line or the hooks: the fastest way to tell whether a problem is turno's.
# call a tool as a session would
turno mcp call github list_issues \
--arg repo=wimo-dev/turno
# a Markdown block for an issue, no secrets
turno doctor --report
# open the agent without turno's gateway
turno run work --no-gatewayBrowser
identity.json: pins each identity's time zone, languages, locale and region, so a site sees the same browser every session.- A health check: a URL and a text or selector mark a signed-out identity, and tool calls then ask for
turno browser login <id>instead of failing on a login page. turno browser reputation: shows the captchas and "verify it's you" pages each identity met, per site.turno browser doctor: checks Chrome, a smoke launch, the desktop session and every identity, with a fix for each problem.- Lifecycle: Chrome closes after 15 minutes without a tool call and opens again on the next one, and a Chrome left behind by a killed session is closed on the next start.
- Settings by flag: all of these settings can be changed with flags on
turno identity setorturno browser set. Browser identities. - Its own MCP server:
turno-browsernow hosts its MCP server itself instead of wrapping Playwright's program. The 25 tool names, their inputs and every flag are unchanged.
Gateway
turno mcp export: prints yourmcp.tomlwithout secret values and lists theturno secret setcommands the other machine needs.turno mcp import: merges that export there, or a JSONmcpServersfile, or a Codexconfig.toml. Remote servers that answer with an OAuth challenge are markedauth = "oauth"on the way in.- Memory pressure: under critical memory pressure mcpd stops a quiet browser even while its session lives, and
stop_graceper server sets how long it waits before stopping one.
CLI
- Install it your way: npm, pnpm, bun, yarn and Homebrew are all first-class.
turno upgradeandturno versionrecognize each one, and a one-offnpx,pnpm dlxorbunxrun says which command gets the newest release instead of installing turno globally. Install. - Next steps: commands that write end with a
Next:line.
Packages
turno-core: a new package that holds whatturno-cliandturno-browsershare: paths, the secret store and process helpers. Nothing changes for you.- Homepage: the packages' homepage is turno.wimo.dev.
Changed behavior
What can break a script or a habit when you upgrade from 0.2:
turno auto: exits 3 (was 1) when the folder has no profile.turno mcp daemon status,turno mcp topandturno mcp savings: exit 5 (was 1) when mcpd is down.- Gateway entries of Copilot CLI and Cursor CLI: gained a header. Run
turno mcp synconce after upgrading.
Links
- Full changelogs: turno-cli, turno-browser, turno-core and turno-fonts.
- Browser: Browser identities and What turno stores and where.
- Scripts: Exit codes and JSON output.