Release notes 2.x
Notable changes in Kurlo 2.0.0 through 2.6.1.
Notable changes in Kurlo 2.x, from 2.0.0 to 2.6.1. For 3.0.0 and later, see the current release notes. Notes for 1.x are in Release notes 1.x.
Changed
Section titled “Changed”- Clearer load-test editor. A plan line summarises the test and jumps to each setting, a Custom card shows when settings match no preset, tabs with something to fix are marked, flows read as setup and per-iteration steps with saved and used values, and pass criteria read as sentences. See Load testing with k6.
- Easier load runs and results. Runs show the current stage, remaining time and planned load; results compare each threshold with its limit and chart per-step p95.
- New load tests start as drafts. They reach the collection only when saved, get their own tab and ask to save when closed; a collection’s New load test includes all its HTTP and GraphQL requests, and folders offer the same, and an empty flow lists requests to tick in run order.
- Load tests from the sidebar. Tests sit in a collapsible Load tests group, each shows its last result, and its menu runs it or exports its k6 script.
- Git in the status bar. The branch at the bottom left opens Git and shows commits to push and pull, changed files and merge or missing-remote flags; the duplicate activity-bar button is gone. See Git-backed workspaces.
- Missing secrets in plain words. The dialog groups secrets by request, collection, environment and cookies and names each one instead of showing internal ids. See Git-backed workspaces.
- Mock server and runner layout. The mock server keeps its status, URL and Start/Stop in one bar and names the example that hides another. The runner groups settings and requests, shows the total number of calls and can show only failures. See Mock server and Collection Runner.
- Load testing with k6. Build flows from saved HTTP and GraphQL requests, choose smoke/load/stress/spike/soak presets, and set virtual users or iteration rates with response-time and error thresholds. Tests are collection YAML files. See Load testing with k6.
- Setup, checks and test data. Run setup once per virtual user, extract response values for later steps, add checks and waits, and preview CSV/JSON data. Replace requests without losing step settings; save and revert tests like ordinary requests.
- Local runs, exports and reports. Run installed k6, follow progress, stop a run and inspect per-step results and thresholds. Save summary JSON and HTML reports, or export a script or folder with test data. Secrets stay outside exports by default. See Run locally.
- Load testing in the terminal and CI.
kurlo load list|export|runuses the same definitions, supports environment overrides and reports, and exits with code 99 when thresholds fail. See CLI load testing. - A complete guide and landing-page feature. Seven reproducible screenshots cover the flow, profile, data, export, k6 installation, active run and completed result.
- Current request edits reach load tests. Pending names, URLs and settings are used; invalid literal URLs are rejected before a run. Once-per-user pacing, late Stop results, millisecond waits, extraction and small percentage limits behave consistently.
- Load-test controls remain responsive. Output is batched and bounded, validation stays beside its field without moving neighbouring controls, request menus fit the editor, and matching presets are highlighted.
- Stable updates and safer saves. Stable updates exclude prereleases and macOS-only builds. Autosave backs off after failures, workspace writes respect operating-system locks, YAML validation ignores stale results, and release notes are marked seen after loading.
- Sturdier connections and authentication. Realtime connections reject stale events and enforce deadlines. Cookie sync validates its host and extension origin. Scripts share collection updates, changed client certificates reload, CORS preflights keep separate timings, AWS query signing preserves spaces, and concurrent CLI sends share OAuth refreshes.
- Consistent editor feedback. Failed model follow-ups preserve the message, Git lists resize correctly, and examples follow external edits. Response badges animate on every send; relative times update, and dates and numbers use English formatting with a 24-hour clock.
- OAuth 1.0 auth: HMAC, RSA and PLAINTEXT signatures, in the header, the query or a form body, with the secrets kept out of the YAML. See Authentication.
- Find and replace across a collection or a folder, with a preview of every match and Undo. See Find and replace.
- Thirteen more keyboard shortcuts: cancel a request, copy as cURL, find and replace, response layout, sidebar views, environment picker, new collection, import, collection runner, and closing other or all tabs. See Keyboard shortcuts.
- Opening a request or closing a tab in a large workspace no longer saves the whole workspace, and saving a change reads the local store once. See Performance fixtures.
- Secret gRPC metadata and Socket.IO event rows, and secret rows without an id, are kept out of the YAML.
kurlo runskips SSE, MCP and AI requests, and the Collection Runner skips MCP requests instead of sending them as empty HTTP requests.- AI requests: thinking with temperature or top P on Anthropic, a stream cut before a signature,
pause_turn, empty event streams, and OpenAI-compatible servers that refusestream_optionsor a token-limit field or send tool calls without an id. - With Tengo selected, scripts from a Postman, Insomnia or Bruno import go to the JavaScript fields instead of failing in Tengo, and exports to those formats take the JavaScript scripts. See Import and export.
- The shortcut list in Settings no longer scrolls sideways, and its keys line up in columns.
- Merge conflicts in the diff3 style no longer put the base text into Ours.
- Git status and diffs no longer race a running commit, pull or rebase, and an unreadable saved token is reported.
- Postman, Insomnia, Bruno, HAR and cURL imports and Postman exports keep more of the source: v2.0 auth, OAuth 2.0 grants and fields, disabled rows, binary bodies and folder names. See Import and export.
- OpenAPI imports handle media type parameters,
2XXresponses, overridden parameters, cookie API keys and YAML anchors, and exports skip gRPC, MCP and AI requests. - Collection variables set by gRPC and AI scripts are saved, and the environment matrix shows the value a send uses for duplicated keys.
- Sturdier connections: no late
Disconnectedafter a WebSocket or SSE reconnect, write deadlines for WebSocket and Socket.IO, and no lost gRPC stream messages. - The mock server, the Collection Runner and history entries over the size limit behave better in long sessions.
- Safer local data: case-only name clashes, atomic writes for credentials and keys, the workspace lock for every load and YAML save, an encrypted cookie sync token, random pairing ids, and an atomic app bundle swap on macOS update. See Cookies.
- AI requests: send a prompt to OpenAI, Anthropic, OpenRouter, Groq, Ollama, LM Studio or any OpenAI-compatible API, and follow the streamed answer with its thinking, tool calls, stop reason, timings and tokens. Reply continues the chat. See AI requests.
- MCP servers as tools for the model: tick MCP requests on the Tools tab, and Kurlo runs the model’s tool calls with their URL, auth and headers. See Tools from MCP servers.
pm.response.llm()in tests: the answer of an AI request in one shape for every provider. See Scripting API.- Markdown docs for every request: Edit with a live preview, and a Preview that adds a reference built from the request’s URL, params, headers and body. See Docs.
- Response layout button in the status bar, to put the response beside or below the request.
Changed
Section titled “Changed”- AI conversations read like a chat: Markdown answers, the full width of the panel,
Enterto send, and a lighter Raw view for long conversations. See AI requests. - Full request address under the base URL of an AI request, with the added API path highlighted. See AI requests.
- Clearer model list errors: what went wrong, the status and address, and what to try next.
- Length limits for AI prompts: 200,000 characters for the prompt and chat messages, 50,000 for the system prompt, with a counter near the limit.
- The AI prompt field fits its text and grows as you write, up to the free height of the tab.
- Shorter method menu: HTTP methods and the other protocols side by side.
- The provider and model box closes when you click it again.
- With the response beside the request, neither side can be dragged too narrow, and settings rows stack on a narrow panel.
- The AI prompt field no longer scrolls its text under the border in a short window.
- An invalid AI setting is explained right below its field, and a narrow response panel keeps the status code visible.
- Provider errors in the AI chat wrap inside the panel and come with their status and a hint.
- A base URL with a query string, such as an Azure OpenAI
?api-version=…URL, gets the API path before the query string. - The AI chat’s send button is visible in light themes while the message is empty.
- With the response beside the request, the response panel’s lines reach the divider, which is now a single line with a wider grab area.
- New MCP request on an AI request’s Tools tab opens a draft instead of leaving an empty request in the collection.
- The code snippet of an AI request now posts the prompt, model and settings to the full API address. See Code generation.
- A long model name no longer pushes the metrics and New chat off the AI status line.
- A long bearer token no longer runs under the show/hide button in the Auth tab.
- Path variables: a
:namesegment in the URL gets its own row under Path variables in the Params tab, and its value goes into the URL when the request is sent. See Path variables.
- Star Kurlo on GitHub from Settings › Support. After your twentieth successful request a “Star on GitHub” link also appears once in the status bar; the count stays on your machine.
.keysin test scripts:.to.have.all.keys,.to.have.any.keys,.keysand.key, as in Chai. See Scripting API.
- A request body is no longer lost when a request file names a body type Kurlo does not know, such as
raw: it is read as the type inrawBodyType, or as text. - Changes made outside Kurlo keep the open request on its tab. An assistant, an editor or
git pullchanging the workspace no longer moves you to Params.
- Prompts for AI assistants:
sync_collection,cover_endpointanddebug_last_failureinkurlo mcp. See Prompts. generate_testswrites status,Content-Typeand JSON schema tests from a real or described response, and saves it as an example. See Tests from a response.diagnose_last_failureexplains why the last failed request from the app failed. See When a request fails.
Changed
Section titled “Changed”- A JSON body can be passed as an object to
save_request,save_exampleandgenerate_tests.
- MCP requests reach servers built before stateless MCP. Kurlo opens a session with servers that speak revisions 2025-11-25, 2025-06-18 or 2025-03-26 and names the revision in the panel. See MCP.
kurlo mcpis in the official MCP Registry asdev.kurlo/kurlo.
- Saved responses in History survive a restart again, including those of entries that lost the link before this release.
- Claude Code now sees Kurlo’s tools.
kurlo mcpwas shown as connected with no tools, because Claude Code’s newer MCP revision rejected its tool list.
- Long release notes no longer hide the update button in Settings → About.
- AI agents can keep your collections up to date.
kurlo mcpcan create collections, add and change saved requests with theirpm.*tests, save responses as examples and set environment variables, writing the same YAML the app does. Secrets are never written. See Writing to the workspace. - Your agent sees what you just sent.
list_historyandget_history_entryread the requests you send from the app, with responses, tests and logs, secrets masked. See What you just sent from the app. kurlo mcp installadds Kurlo to Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf and Gemini CLI in one command, or to a repository’s shared config with--project. See Connect an assistant.- Protected environments that AI agents cannot send requests with or change. See Environments.
- Docs for language models: llms.txt and llms-full.txt.
Changed
Section titled “Changed”- A token that is only a
{{variable}}stays in the shared YAML instead of moving to the encrypted local file, so a cloned workspace works with your own environment.
- Files changed outside Kurlo are no longer overwritten. The app reloads changes made by
kurlo mcp, an editor orgit pullwithin a second, and a save that races with one keeps both.
- The cookie sync extension comes with the app. In Cookies → Sync cookies, pick your browser and Kurlo puts the extension in a folder with the steps to load it, at the same version as the app. Releases also attach it as a zip. See Cookies.
kurlo mcplists the variables a request was missing inunresolvedVariables. See MCP server.
Changed
Section titled “Changed”- Updates moved into About, with the update state, one action, automatic install and release notes in one place.
- Large workspaces open, search and save much faster: 10,000 requests appear in about a second instead of 24, and importing them saves in seconds instead of minutes on macOS.
- Workspace files no longer carry
createdAtandupdatedAt, so reloading no longer changes cookie timestamps in Git.
- No more changes you never made after opening a workspace, switching branches or pulling.
- An interrupted save can no longer lock the workspace or lose a new secret.
- Bruno, OpenCollection and Insomnia exports keep
{{variables}}and scripts. - Save to file keeps binary responses intact.
- Cancelling and resending, or switching environments mid-request, no longer mixes up results.
- Search covers Starred requests, and the GraphQL explorer shows arguments and every field of the schema.
- The command line is on npm:
npx -y @kurlo/cli.kurlo runandkurlo mcpwork without the desktop app, on macOS, Linux and Windows. An AI agent connects withclaude mcp add kurlo -- npx -y @kurlo/cli mcp, and CI runs a workspace withnpx -y @kurlo/cli run ./workspace --env CI. See MCP server and CLI runner. - AI assistants can check a call the way a browser would.
run_requestandsend_requesttakebrowserOriginand report the CORS error a browser on that page would raise. See Checking a call the way a browser would. list_requestssearches withquery,get_requestshows saved examples and the browser settings in effect, andrun_collectionreports progress after every request.
kurlo runandkurlo mcpnow honor browser emulation. Requests with Enforce CORS or CSP on, by themselves or through their collection, were sent as plain requests. A CORS or CSP refusal now fails the run, as it would in the browser.
- On Linux, closing the window quits Kurlo. It used to hide the window and keep running with no way back, and opening Kurlo again could bring back a blank window. Windows quits on close too; macOS keeps the app in the Dock as before.
- Quit works when the window has stopped responding. If the window does not answer within five seconds, Kurlo quits anyway. A window still asking whether to save your changes is never cut short.
- Restart after an update reopens Kurlo on Windows, where the new version started hidden, and on Linux, where it did not start at all.
- The Linux AppImage installs updates. Kurlo replaces the
.AppImagefile it was started from, so keep it in a folder you can write to. AppImages from 2.2.3 and earlier cannot update themselves: download 2.2.4 by hand once. See Installation.
Changed
Section titled “Changed”- A new landing page shows how to bring a Postman, Insomnia or Bruno collection across, which features other clients
keep behind a paid plan, and a dated side-by-side comparison of Kurlo, Postman, Insomnia and Bruno.
kurlo.dev/pricinganswers with a 404, because there is nothing to buy.
- The Linux AppImage starts on Ubuntu 24.04 and later. Linux builds now use WebKitGTK 4.1, available on Ubuntu 22.04 and later, Debian 12 and later and Fedora 37 and later. Ubuntu 20.04 and Debian 11 are no longer supported. See Installation for the packages to install.
- A fresh install no longer opens on “Folder missing” before the first save creates the default workspace folder.
- Kurlo can always be closed: when the last save fails, it asks whether to quit without saving.
- Moving Kurlo’s data folder no longer leaves the default workspaces “missing”, and a missing workspace folder can switch back to Kurlo’s built-in storage in one click.
- The macOS disk image window no longer scrolls when Finder shows hidden files.
- The download buttons on this site show a new release as soon as it is published.
Changed
Section titled “Changed”- A new app icon: a pigeon in Kurlo’s blue, in the app, the installers, the browser extension and on this site.
- The macOS disk image is quieter and sharp on Retina displays — a small wordmark, an arrow to Applications and one line of instructions.
- The Windows installer artwork follows the new icon.
- The documentation lives only at kurlo.dev.
- AI assistants can use Kurlo as tools.
kurlo mcpruns the desktop binary as a Model Context Protocol server, so Claude, Cursor and other MCP clients can list your requests and environments, run a saved request or a whole collection, and send one-off calls with your{{variables}}. Values a script sets carry over to later calls, and secret values are masked in everything the assistant gets back. See MCP server.
Changed
Section titled “Changed”- The installers look like Kurlo. The Windows installer is a modern wizard with Kurlo’s artwork and a quieter install, and the macOS disk image has a branded background laid out for dragging the app to Applications.
- The site moved to kurlo.dev, and its download button now downloads the right file for your platform instead of opening the releases page.
- Importing a
.envfile keeps backslashes, so Windows paths such asC:\new\tmpsurvive. kurlo runno longer crashes on a very large--iterations.- Swift snippets encode multipart field names with a backslash or quote the way browsers do.
- The cookie-sync dialog’s guide link opens Connecting a browser instead of the top of the page.
Security
Section titled “Security”- The client key passphrase is no longer saved in plain text by Save as default. A passphrase an earlier version stored is removed on the next launch.
- Kurlo opens on the request editor — your tabs, or a new request when there are none. Settings → General → On launch can reopen Where you left off or always start on the Workspace overview. See Settings.
- Zoom.
Cmd/Ctrl =,Cmd/Ctrl −andCmd/Ctrl 0scale the whole window from 80% to 150%, as in Postman; on macOS they are also in the new View menu. See Keyboard shortcuts. - Browser emulation goes further. The Headers tab marks the response headers page code cannot read under CORS, a page on HTTPS is checked for mixed content, and a request from a public page to a loopback or private address warns about Local Network Access. See Browser security.
Changed
Section titled “Changed”- One look across the app. Text, buttons, fields, menus, tabs, dialogs, checkboxes and empty states come from one set of sizes, weights, corners and spacing, so the same control looks the same on every screen. Destructive actions and status colours follow the theme, and the last system checkboxes and radio buttons are gone.
- CORS follows every redirect — the redirect must pass CORS, a new origin is preflighted, cookies and
Authorizationare dropped as a browser drops them — and header values are checked as the Fetch standard does. A redirect on the same host keepsAuthorization. - Variables resolve as expected. Globals reach
{{...}}, a value set by a pre-request script is used in the same send, names with non-Latin letters, spaces or colons resolve, the Collection Runner hands scripts the data row, andkurlo runresolves nested variables. See Environments. - A timeout of
0waits as long as the server takes, in the app and inkurlo run. See Request settings. - Large responses scroll without blank frames on the scrollbar, the trackpad and the keyboard, and **response search ** highlights matches across a key and its value.
- Arrow keys stay where you are. In a response, a dialog or Settings they no longer switch the request in the
sidebar, and
↓in Settings no longer skips a section. - Streaming and sockets: a
POSTto an event-stream endpoint shows the stream, SSE follows the event-stream specification, a quiet WebSocket with keep-alive off stays open, handshake headers copied from DevTools no longer break connections, and Socket.IO shows binary events. - Pasted cURL commands and generated snippets keep the body —
-d,--json,$'...'quoting,-d @file— and the snippets run as generated in every language. See Code generation. - Also: the mock server replays compressed examples, a hand-written multipart
Content-Typeno longer loses its boundary, force push refuses to overwrite commits it has not seen, common legacy Postman script helpers work, OpenAPI import honours servers on a path or operation, and the Runner’s checkboxes stay checked during a run.
Changed
Section titled “Changed”- A new request opens straight away as HTTP. The
+in the tab bar,Cmd/Ctrl Nand Add request no longer ask for a protocol first. Switch protocol in the picker at the start of the address bar — on a saved request until it has a URL — or run New GraphQL request, New WebSocket request and the rest from the command palette. See Request types. - Shortcuts are drawn as keys in Settings, the command palette and the hints —
⌘ ⇧ ⌥on macOS;Ctrl,Alt,⇧ Shiftand the Windows logo on Windows. - The Windows installer no longer asks for administrator rights. It installs for the current user, so there is no UAC prompt and the in-app updater can replace the app. It offers to remove an older all-users copy; your data is kept. See Installation.
- The Windows icon fills its space on the taskbar and in the Start menu instead of sitting inside the macOS margin.
- Updating the MSIX install failed with a permission error. Kurlo now recognises the packaged install and offers the
new
.msixfor this machine instead of trying to replace itself. - Some shortcuts never fired on Windows and Linux — Reopen closed tab, Toggle right sidebar, Switch to next/previous tab and Force close tab. Shortcuts also follow the physical key now, so they work on Cyrillic and other non-Latin layouts.
Cmd/Ctrl+Enterin a WebSocket or Socket.IO message dropped the connection, and in a gRPC message invoked the method twice. It sends once now.- Shortcut hints ignored your own bindings; they show the current binding now.
- Some text kept the previous theme’s colour — the Mock server heading stayed black after switching to Nord — and buttons on light accents were hard to read in Nord, the dark Catppuccin flavours, Dark Pastel and Dark Monochrome.
- Full release notes did nothing in What’s new; it opens the release page now.
- Kurlo runs on Windows on Arm. Releases now carry an Arm64 installer and MSIX package beside the x64 ones; the x64 installer refused to start on Arm machines. See Installation. (#34)
- A middle click closes a tab, as in a browser — request tabs and the Runner, Git, Mock, collection and History tabs. A tab with unsaved changes still asks first.
- Enter in the URL field did nothing. It now sends the request, or connects a WebSocket, Socket.IO or SSE request. It never cancels a request in flight or drops a live connection, and it still picks a suggestion while the variable list is open.
- An update on macOS left the old icon behind. The in-app updater replaced only the program inside
Kurlo.app, so the icon and the version Finder shows stayed from the day Kurlo was first installed. Updates now replace the whole signed app, and a copy that was updated the old way repairs itself on its next start — the new icon appears from the launch after that. - Every release called itself 1.0.0 to the operating system. The release build stamped its real version into the program but never into the app’s own description, so Finder and About This Mac on macOS, and the file properties and Apps & features on Windows, showed 1.0.0 whatever version was installed. They show the actual version now.
Kurlo 2.0 is a new look — the Graphite design, from the window chrome to every screen, menu and dialog — plus MCP requests, a command palette, a page for each history entry and the last run of each collection. It needs macOS 12 or later.
- MCP is a request type. Point Kurlo at a Model Context Protocol server, press Discover, pick a tool, fill the arguments from its schema and send — and read the raw JSON-RPC exchange that went over the wire. An MCP call is an ordinary saved request: diffed in review, run by the collection runner, asserted on by a test script. See Request types.
- A command palette.
Cmd/Ctrl Kfinds a saved request and also runs Kurlo’s commands — send, save, duplicate, copy as cURL, create, import, jump to any view, change the layout or theme. See Workspaces. - Environments side by side. A Matrix view puts every variable in a row and every environment in a column, edited in place. See Environments.
- A page for each history entry, with what was sent next to the stored response. See Request history.
- Each collection remembers its last run, shown in the runner and on the collection’s page. See Collection Runner.
Changed
Section titled “Changed”- The Graphite design. Neutral greys with hairline borders, colour kept for what carries meaning — methods, status codes, variables — and the accent only on the primary action. An activity rail replaces the sidebar’s section labels, tabs sit in the title bar, the method lives inside the URL field, and the response opens beside the request in a wide window. Every screen, menu and dialog was brought to it, and every screenshot in these docs was retaken.
- A new app icon — two offset chevrons in the brand blue — on the Dock, the installer, the start-up screen and these pages.
- Kurlo needs macOS 12 Monterey or later, with the system WebKit from Safari 16.2 or newer. Windows and Linux are unchanged.
- A dropdown inside a labelled field reopened after an option was picked on macOS. The end-to-end suite now also runs in WebKit, the engine Kurlo uses there.
- A stored history response over 2 MB could not be read back.
- Response line numbers fell behind the text while scrolling fast on macOS, and a sideways scroll could strand them in the middle of a wide response.
Was this page helpful?