Skip to Content

Releases

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.

View source

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 upgrade

Updates 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@latest

Then 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 school
Credential vault

Browser

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 school
Moving a session

Browser

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 10m
Tabs

Browser

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.

Actions

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 --cache
Blocking and the resource cache

CLI

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.

JSON output

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-gateway
Troubleshooting

Browser

  • 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 set or turno browser set. Browser identities.
  • Its own MCP server: turno-browser now 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 your mcp.toml without secret values and lists the turno secret set commands the other machine needs.
  • turno mcp import: merges that export there, or a JSON mcpServers file, or a Codex config.toml. Remote servers that answer with an OAuth challenge are marked auth = "oauth" on the way in.
  • Memory pressure: under critical memory pressure mcpd stops a quiet browser even while its session lives, and stop_grace per 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 upgrade and turno version recognize each one, and a one-off npx, pnpm dlx or bunx run 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 what turno-cli and turno-browser share: 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 top and turno mcp savings: exit 5 (was 1) when mcpd is down.
  • Gateway entries of Copilot CLI and Cursor CLI: gained a header. Run turno mcp sync once after upgrading.

On this page