Skip to content
kurloStarDownload

Agent mode · New in Kurlo 3.0

Justask.

Ask in plain words. The agent runs your requests, finds out why one failed and writes the missing test. Bring any model, Claude Code or Codex, and approve every change.

LiveNot a screenshot

Go on,press Apply.

Pick who answers

One chat list for all three. Switch per chat.

Kurlo — Agent
Why does Cancel order fail?Claude Code · Opus 5.5 · High

Cancel order keeps failing. Fix the test if the API is right.

  1. ✓Read a request Shop API/Orders/Cancel order DELETE
  2. ✓Ran a request DELETE /orders/41 409 51 ms

Order 41 has already shipped, so the API answers 409 Conflict. That’s by design; the test expects 204. I’ll test for the conflict instead.

⛉ Change 1 file?save_request

requests/Cancel-order.yml

    testScriptJs: |
-       pm.test("status is 204", () => pm.response.to.have.status(204))
+       pm.test("refuses shipped orders", () => {
+           pm.response.to.have.status(409)
+           pm.expect(pm.response.json().error).to.eql("order_shipped")
+       })

Ask to run, explain or change something

Shop APIStagingTemplatesClaude plan · 5-hour window 82% left

Three agents, one chat list

Bring your own.

Pick who answers in the message box. Kurlo has no credits of its own, so you use the model or the plan you already have.

Kurlo agent

Runs on
Any model you connect in Settings → AI: sign in with OpenRouter, add an Anthropic, OpenAI or compatible key, or pick Ollama or LM Studio on this machine.
You pay
Your provider, or nothing at all with a local model.
  • Pick a model per chat
  • Models good at tools are marked Recommended
  • Keys encrypted with your system keychain

Claude Code

Runs on
The Claude Code CLI on this computer, signed in with its own account. Kurlo finds it, or starts the official sign-in.
You pay
Your Claude plan, or the API key the CLI uses.
  • Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.5
  • Effort from Low to Max
  • 5-hour and weekly limits read with /usage, which uses no tokens

Codex

Runs on
The Codex CLI on this computer, signed in with ChatGPT or an API key. Read-only sandbox, shell switched off.
You pay
Your ChatGPT plan’s usage, or API billing.
  • Effort levels the model supports
  • Plan limits as bars with reset times
  • Native sessions continue across restarts

How to connect each one

What to ask

Plain words.

Chips in the message box pick the collection and environment, and Templates fill in the common jobs. The rest is a sentence.

Why did my last request fail?

Reads the history entry, compares it with the saved request and the environment, and names the cause.

Run the Orders folder and explain what failed.

Runs the collection with its auth, scripts and tests, then goes through each failed test.

Write tests for Create order.

Sends it, reads the response and proposes pm.test checks for status, shape and values.

Cover POST /orders/{id}/refund.

Adds a request to the collection with a body, variables and tests, ready to apply.

Explain the Login request.

Walks through its auth, headers, scripts and which variables it sets for the next call.

Point Staging at the new host.

Proposes the variable change in the environment file, so you see the exact line first.

Approvals

It asks first.

The same rules for all three agents. Reading is free; anything that changes a server or your files waits for you.

The agent wants toDetailsWhat happens
Read requests, environments, historyListing, reading and diagnosing a failure.At once
Send GET, HEAD, OPTIONSRuns, collection runs and one-off calls that only read.At once
Send POST, PUT, PATCH, DELETEThe card shows the call before it goes out.Asks first
Change workspace filesThe exact YAML lines, file by file: Apply, Reject or Allow for this chat.Asks first
A file you edited meanwhileThe agent’s change is dropped and it is told to try again.Yours wins
SecretsReach your API. The model gets [secret] and never writes a value into YAML.Masked
Protected environmentsListed, but no agent can send with them. You run those yourself.Refused

Privacy

Stays home.

No. 01

Encrypted chats

Kept in your local profile, never in the workspace, so they never reach Git. 90 days after the last message.

No. 02

An activity log

Every tool call, by the agent or by an assistant on kurlo mcp, with its arguments, result and the files before and after. Encrypted, 30 days.

No. 03

No Kurlo account

There is no Kurlo server between you and the model. Requests go to your provider or to the CLI on this computer.

No. 04

A Stop that stops

Stop ends the turn even before the first reply. Unanswered approvals end it after 30 minutes, and a turn ends after 50 steps.

The other way round

Or stay in your terminal.

Agent mode works on your requests, not your code. When the fix is in the server, give the coding assistant you already use the same tools with kurlo mcp: it runs the collection, changes the code and runs it again.

Kurlo as an MCP server and client

FAQ

Fair questions.

Which agents work in Agent mode?

The Kurlo agent with any model you connect, and the Claude Code and Codex CLIs installed on this computer. All three share one chat list, and each chat keeps the agent it started with. Read more

What does it cost?

Nothing from us. The Kurlo agent runs free on a local model or on your own key, and Claude Code and Codex use the plan you already pay for.

Do I need Claude Code or Codex?

No. The Kurlo agent works with OpenRouter, an Anthropic, OpenAI or compatible key, or a local Ollama or LM Studio model. Read more

Can it break my collection?

Not without your Apply. Every change is shown line by line first, nothing is written while the card waits, and the files are YAML in Git, so any change can be reverted.

Does the model see my tokens?

No. Secrets reach your API, but the model gets [secret], and protected environments are off limits to every agent.

How is this different from kurlo mcp?

Same tools, other side. Agent mode runs the agent inside Kurlo with approval cards. kurlo mcp hands the tools to the assistant in your terminal or editor, which can also read and fix your code. Read more

Agent mode · Kurlo 3.0 · Free

Ask it.

Your requests, your model, your Apply. Nothing changes until you say so.

macOS 12+ · Windows 10+ · Ubuntu 22.04+ · x64 and Arm64