@kurlo/cli 0.0.0-stage → 2.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kurlo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# @kurlo/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The command line of [Kurlo](https://kurlo.dev), a free, open-source desktop API client. It runs the requests and test scripts of a Kurlo workspace, and serves a workspace to AI agents as an MCP server. You don't need the desktop app installed to use it.
+
+```bash
+npm install -g @kurlo/cli
+kurlo --version
+```
+
+## Connect an AI agent
+
+Claude Code:
+
+```bash
+claude mcp add kurlo -- npx -y @kurlo/cli mcp --env Staging
+```
+
+Codex:
+
+```bash
+codex mcp add kurlo -- npx -y @kurlo/cli mcp --env Staging
+```
+
+Cursor, Claude Desktop and other clients with a JSON config:
+
+```json
+{
+  "mcpServers": {
+    "kurlo": {
+      "command": "npx",
+      "args": ["-y", "@kurlo/cli", "mcp", "--env", "Staging"]
+    }
+  }
+}
+```
+
+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.
+
+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:
+
+```bash
+npx -y @kurlo/cli mcp ./api --env Staging
+```
+
+## Run collections in CI
+
+```bash
+npx -y @kurlo/cli run ./api --env CI --reporters cli,junit
+```
+
+The run exits non-zero when a request fails or a test does not pass.
+
+## Docs
+
+- [MCP server](https://kurlo.dev/docs/guides/mcp-server/)
+- [CLI runner](https://kurlo.dev/docs/guides/cli-runner/)
+- [Git-backed workspaces](https://kurlo.dev/docs/guides/git-workspaces/)
+
+Prebuilt binaries are published for macOS, Linux and Windows on x64 and arm64. MIT licensed.

package/bin/kurlo.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+const platforms = {
+  'darwin arm64': '@kurlo/darwin-arm64',
+  'darwin x64': '@kurlo/darwin-x64',
+  'linux arm64': '@kurlo/linux-arm64',
+  'linux x64': '@kurlo/linux-x64',
+  'win32 arm64': '@kurlo/win32-arm64',
+  'win32 x64': '@kurlo/win32-x64',
+};
+
+const target = `${process.platform} ${process.arch}`;
+const pkg = platforms[target];
+if (!pkg) {
+  console.error(`kurlo: there is no prebuilt binary for ${target}. Supported: ${Object.keys(platforms).join(', ')}.`);
+  process.exit(1);
+}
+
+let binary;
+try {
+  binary = require.resolve(`${pkg}/bin/kurlo${process.platform === 'win32' ? '.exe' : ''}`);
+} catch {
+  console.error(`kurlo: ${pkg} is not installed. It is an optional dependency of @kurlo/cli, so reinstall without --no-optional or --omit=optional.`);
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit', windowsHide: true });
+if (result.error) {
+  console.error(`kurlo: could not start ${binary}: ${result.error.message}`);
+  process.exit(1);
+}
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@kurlo/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.2.5",
+  "description": "Kurlo's command line: run API collections in CI and serve them to AI agents over MCP.",
+  "keywords": [
+    "api",
+    "api-client",
+    "http",
+    "mcp",
+    "mcp-server",
+    "postman",
+    "cli",
+    "testing"
+  ],
+  "homepage": "https://kurlo.dev",
+  "bugs": "https://github.com/stormhop/kurlo/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stormhop/kurlo.git",
+    "directory": "npm/cli"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "kurlo": "bin/kurlo.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@kurlo/darwin-arm64": "2.2.5",
+    "@kurlo/darwin-x64": "2.2.5",
+    "@kurlo/linux-arm64": "2.2.5",
+    "@kurlo/linux-x64": "2.2.5",
+    "@kurlo/win32-arm64": "2.2.5",
+    "@kurlo/win32-x64": "2.2.5"
+  }
+}