@kurlo/cli 2.2.5 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +21 -1
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -7,8 +7,28 @@ npm install -g @kurlo/cli
7
7
  kurlo --version
8
8
  ```
9
9
 
10
+ ### `EACCES: permission denied` on `npm install -g`
11
+
12
+ npm could not write to the folder that holds global packages. It happens with Node from the nodejs.org installer, which puts that folder in `/usr/local`, owned by the system. It is not specific to Kurlo, and any global package fails the same way. Either skip the install and run the CLI with `npx -y @kurlo/cli`, or move global packages into your home folder once:
13
+
14
+ ```bash
15
+ mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
16
+ echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
17
+ npm install -g @kurlo/cli
18
+ ```
19
+
20
+ Node installed with Homebrew, Volta or nvm keeps global packages in your home folder already. Avoid `sudo npm install -g`: it works, but leaves root-owned files that break later installs.
21
+
10
22
  ## Connect an AI agent
11
23
 
24
+ Add Kurlo to every AI client on your machine (Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, Gemini CLI):
25
+
26
+ ```bash
27
+ npx -y @kurlo/cli mcp install --env Staging
28
+ ```
29
+
30
+ Add `--project` to write the repository's shared `.mcp.json` and `.cursor/mcp.json` instead, `--dry-run` to see the changes first, and run `kurlo mcp uninstall` to take Kurlo out again. To set it up by hand instead:
31
+
12
32
  Claude Code:
13
33
 
14
34
  ```bash
@@ -34,7 +54,7 @@ Cursor, Claude Desktop and other clients with a JSON config:
34
54
  }
35
55
  ```
36
56
 
37
- The agent can list your requests and environments, run a saved request or a whole collection with its tests, and send one-off calls that use your `{{variables}}`. Secret values are sent to your API and masked as `[secret]` in everything the model sees.
57
+ The agent can list your requests and environments, run a saved request or a whole collection with its tests, and send one-off calls that use your `{{variables}}`. It can also add and change saved requests with their tests, save responses as examples and set environment variables, so the collection stays in step with your code. Secret values are sent to your API and masked as `[secret]` in everything the model sees, and never written to the workspace. Mark an environment protected in the app to keep agents away from it.
38
58
 
39
59
  With no workspace argument, `kurlo mcp` serves the workspace the desktop app has open. Pass the folder that contains `kurlo.yml` to serve a Git-backed workspace instead:
40
60
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kurlo/cli",
3
- "version": "2.2.5",
3
+ "version": "2.3.0",
4
4
  "description": "Kurlo's command line: run API collections in CI and serve them to AI agents over MCP.",
5
5
  "keywords": [
6
6
  "api",
@@ -35,11 +35,11 @@
35
35
  "access": "public"
36
36
  },
37
37
  "optionalDependencies": {
38
- "@kurlo/darwin-arm64": "2.2.5",
39
- "@kurlo/darwin-x64": "2.2.5",
40
- "@kurlo/linux-arm64": "2.2.5",
41
- "@kurlo/linux-x64": "2.2.5",
42
- "@kurlo/win32-arm64": "2.2.5",
43
- "@kurlo/win32-x64": "2.2.5"
38
+ "@kurlo/darwin-arm64": "2.3.0",
39
+ "@kurlo/darwin-x64": "2.3.0",
40
+ "@kurlo/linux-arm64": "2.3.0",
41
+ "@kurlo/linux-x64": "2.3.0",
42
+ "@kurlo/win32-arm64": "2.3.0",
43
+ "@kurlo/win32-x64": "2.3.0"
44
44
  }
45
45
  }