turno 0.2.0
A new look for the CLI, folder server sets, OAuth for remote MCP servers, one-step setup and a safer gateway.
- Released
- Packages
- turno-cli0.2.0GitHub releaseChangelog
- turno-browser0.2.0GitHub releaseChangelog
turno 0.2.0 gives the CLI a look you can read at a glance and makes the gateway do more with less. turno init sets everything up in one step, and turno demo shows it without touching your setup. Server sets let each folder see only the MCP servers it needs, the gateway signs in to remote servers with OAuth once per account, and turno mcp top and turno mcp log show what it does. Each profile gets its own gateway token, and the accounts bridge no longer trusts the calling model to say what a delegated run may do.
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
CLI
A CLI you can read at a glance
turno and turno status show sections (here, profiles, machine), each profile as a pill in its status line color, usage bars colored by level with the time to reset, and the one thing to do next. turno limit show, turno mcp list, turno mcp top and turno mcp log share the look.
turno # the status screen, once set up
turno limit show # usage bars and time to reset
turno mcp list # the gateway's servers, as a tableCLI
Set up in one step, or just try it
turno init finds your agents, their profile folders and the MCP servers inside them, previews every change and starts the gateway in the same run. One turno undo reverts it all. turno demo runs everything in a throwaway HOME, with nothing to install.
turno init --dry-run # the plan, changing nothing
turno init # preview, confirm, write
npx turno-cli demo # all of it in a throwaway HOMEGateway
Each folder sees only its servers
A folder rule can say which MCP servers its sessions see, so a work repository does not list your personal tools. The gateway hides the others: they show no tools, refuse calls and never start.
[[projects]]
path = "~/code/acme"
profile = "work"
mcp = ["issues", "docs"] # only these servers
[[projects]]
path = "~/code/oss"
mcp_deny = ["mail"] # every server but theseGateway
OAuth for remote MCP servers
Declare a remote server with auth = "oauth" and the gateway signs in once per account, for every agent and profile on it. Tokens stay in the Keychain or Secret Service, never in files or logs, and are refreshed when they expire.
turno mcp login linear # default login
turno mcp login linear --profile personal # its variantGateway
See what the gateway does
turno mcp top shows each running server's memory, sessions and calls in flight, turno mcp log the tool calls the gateway relayed, and turno mcp savings its memory against the same sessions without it. The log never holds a call's arguments or result.
turno mcp top # memory and calls per server
turno mcp log -f --server github # follow tool calls
turno mcp savings # memory saved by sharingCLI
- Status screen: bare
turnoshows it once turno is set up (the help before that), with sections Here, Profiles and Machine and a Next row with the one command to run.turno status --jsonhas it asnext. turno help: section headers, an Examples block and a "Start here" line, fitted to the terminal width.turno <command> --helpandturno help <command>print the same usage and never run the command.turno init: prints its phases (Found, Plan, Write, Gateway, Sync), shows theconfig.tomldiff and the newmcp.tomlwith TOML colors, and ends with aTry it:line. It also finds MCP servers configured inside profile folders.- Profile picker: a command that needs a profile and gets none (
turno profile assign,turno run,turno limit set, ...) shows the profiles on a terminal as colored pills, with arrow keys or j/k, typing to filter, and Esc to cancel. - One look:
turno limit show,turno mcp list,turno mcp top,turno mcp logandturno identity listshare the pills and columns, fitted to the terminal width. - Colors: one rule everywhere, set with
--color auto|always|neverorTURNO_COLOR, thenNO_COLORandFORCE_COLOR.--jsonis colored on a terminal and stays plain JSON in a pipe. --no-input: a global flag (orTURNO_NO_INPUT=1) that turns every question off. turno also asks nothing inside a coding agent's session.turno doctor: every finding is followed by the command that fixes it or the manual step, in sections with a summary line.--summaryprints one line for hooks and status lines.turno undo: reverts a whole profile setup and sums up each folder in one line;-vlists every change.turno uninstall: removes what turno set up, after listing all of it. The run is journaled, soturno undoputs it back while turno is installed.--purgealso removes its state, caches and installed servers.- Typos:
turno stautssuggeststurno status, and a mistyped flag is an error instead of being ignored. - Faster:
turno --helprenders about 3x faster, andturno,turno statusandturno profile listno longer start oneclaudeper profile on every run.
Gateway
- Server sets:
mcp = [...]andmcp_deny = [...]on a[[projects]]rule. A git worktree follows its main repository's rule, and mcpd reloads config.toml when it changes or on SIGHUP. - OAuth:
auth = "oauth"in mcp.toml,turno mcp loginandturno mcp logout. When a login is missing or was revoked, calls fail with theturno mcp logincommand to run. - One token per profile:
turno mcp syncwrites each profile's own token into its agent config, and mcpd takes the profile from the token, so a profile cannot open a server limited to other profiles.turno mcp token rotateinvalidates every profile token at once. - Tool filters:
tools = { allow = [...], deny = [...] }per server and per profile variant in mcp.toml. Filtered tools are not listed and calls to them fail with a clear error. Changing a filter no longer restarts the server. - Call log:
turno mcp logreads~/.local/state/turno/logs/calls.jsonl(mode 600, rotated at 5 MiB). Error texts have tokens redacted;call_log = falseunder[mcpd]turns it off. - MCP 2026-07-28: mcpd serves agents that use the stateless revision directly, next to 2025-11-25 sessions. Elicitation and sampling still need a 2025-11-25 session.
- Low memory: when the machine is short of memory, idle servers stop after
idle_under_pressure(5 minutes by default) instead of their usual 20 or 30.turno mcp topshows the pressure in its header. - Linux:
turno mcp daemon start|stop|restart|statususe asystemd --userunit, and the LaunchAgent on macOS. - Calls always finish: pressing Esc on a slow tool, closing a session or a new
call_timeoutper server cancels the call on the server too. - Live config: editing mcp.toml applies to sessions that are already open, and a change of tool filter or server set tells them their tool list changed.
- Variables: mcpd expands
${VAR},${VAR:-default}and${env:VAR}in a stdio server's args and env and in a proxied server's headers. A missing variable stops that server with an error that names it. turno mcp install: pins each package to an exact version in mcp.toml, installs without install scripts and keeps a lockfile per server.
Accounts
- Accounts bridge: accounts take
read_toolsandconfirm = "always" | "writes" | "never". A delegated read gets only its read tools, so injected text cannot make it send, post or delete. - Delegated runs: start in turno's own empty folder, load no settings files, get a minimal environment, and come back marked as data from another account, capped at 20,000 characters.
- Audit log: append-only and hash-chained.
turno identity logshows each decision andturno identity log --verifychecks the chain. turno auto: never switches accounts in silence. A missing launcher, a rule that names a missing profile or a broken config.toml stop it with the command that fixes it.copy-artifact: a third skill in the Claude Code plugin copies a claude.ai artifact from one profile's account to another, with its files and assets.
Security
turno doctor --security: checks who can read or write turno's folders (--fixnarrows them), who holds the mcpd port, literal secrets left in config files (it names where, never the value), servers that do not run an exact version, the age of the mcpd token and the audit log's chain.- Secrets:
turno secret setno longer passes the value as a command argument. On Linux,turno secretandkeychain:references use the Secret Service throughsecret-tool. - Private files: turno's folders are created 0700 and the files it writes 0600. Backups are private and pruned after 30 days, always keeping the newest 10.
turno open: accepts only http(s) and mailto links, and works on Linux.- A lighter, locked install:
turno-clino longer pulls inturno-browserandturno-fonts(about 52 MB down to 27 MB), and both packages ship annpm-shrinkwrap.json. No package in either tree runs an install script.
Browser
- Engine ids:
turno browser benchnames its engineschrome-headed,chrome-headless,chrome-baselineandfirefox.--enginestill accepts the old ids. - Asks first:
turno browser benchasks before it opens Chrome on third-party test pages.--only-urlsreplaces--no-detectors, which still works. turno-browser-mcp: refuses--portor--hosttogether with--identity, which would serve a signed-in browser over HTTP.--allow-http-identityaccepts it, and then it listens on 127.0.0.1 only.
Fixes
- Status line: no longer shows
$0.00for a model it has no price for, and a damaged cache, a full disk or a read-only state folder leaves one part of the line empty instead of replacing it with an error. It showsmcpd downwhen the gateway does not answer. - Folders with accents, CJK characters or emoji: no longer break every gateway server. Run
turno mcp syncandturno profile repairto pick up the fix. - mcpd restarts: open conversations keep working afterwards instead of getting 404.
- Shared servers: a confirmation form or sampling request goes only to the session whose call asked for it.
- A broken mcp.toml: no longer keeps mcpd from starting. It serves the last valid copy and shows the error in
turno mcp daemon statusandturno doctor. - A busy port: mcpd runs as a single instance and never moves to another port; it names the process that holds
mcpd.port. turno secret: refuses unknown flags, andturno secret set --helpprints the usage instead of waiting for a value.- Quoted status line paths:
turno doctorand the status screen recognize turno's own status line when its path is quoted.
Changed behavior
What can break a script or a habit when you upgrade from 0.1:
- The master token: mcpd no longer accepts it for MCP sessions. Run
turno mcp synconce. - turno-browser and turno-fonts: no longer installed with turno-cli. Install turno-browser yourself when you use it.
- Exit code 2: a command that needs an answer and cannot ask exits with 2 and names the flag that gives it (
init,uninstallandprofile addused 1). - Bare
turno: shows the status screen once turno is set up, instead of the help. - Accounts without
read_tools: a delegated read is confirmed like a write. Addread_toolsto keep unconfirmed reads. turno auto: exits 1 instead of running the plain agent when the setup is broken.TURNO_ALLOW_PLAIN=1runs the plain agent despite a broken config.turno mcp sync: does not rewrite~/.claude.jsonwhile a plainclaudesession is open, unless you pass--force.- Unknown flags: every
turno mcpsubcommand, and more commands besides, reject them (exit 2) instead of ignoring them. turno browser bench: reports the new engine ids in its table and--json, and without a terminal it needs--yes(--jsonalone no longer runs it).- Profile names:
initanddemocan no longer be profile names.
Links
- Full changelogs: turno-cli 0.2.0 and turno-browser 0.2.0.
- Get started: Try it and First five minutes.
- Concepts: Folder rules, The gateway and Profiles.
- Security and privacy, for what
turno doctor --securitychecks.