clishop 1.5.0 → 1.5.1

package/README.md

@@ -74,13 +74,37 @@ npm link
 
 ## Quick Start
 
-You can create your account on [clishop.ai](https://clishop.ai) or do everything from the CLI:
+You can create your account on [clishop.ai](https://clishop.ai) or do everything from the CLI.
+
+### Human-friendly setup
 
 ```bash
 clishop setup
 ```
 
-The setup wizard walks you through creating an account, adding an address, and linking a payment method. After that:
+This starts the interactive setup flow, creates a resumable setup session, shows a secure payment link, and waits for completion.
+
+### Agent-safe setup
+
+For OpenClaw, MCP clients, Claude-style shells, and other tool runners, use the explicit setup session commands instead of scraping terminal output:
+
+```bash
+clishop setup start --email user@example.com --json
+clishop setup status --setup-id <setup_id> --json
+clishop setup wait --setup-id <setup_id> --timeout 300 --json
+clishop setup cancel --setup-id <setup_id> --json
+```
+
+`setup start` returns immediately with:
+
+- `setup_id`: the resumable setup session handle for the agent
+- `setup_url`: the link the human must open in a browser
+- `expires_at`: when the session expires
+- `poll_after_seconds`: suggested polling interval
+
+The agent sends `setup_url` to the human and keeps `setup_id` locally for `status`, `wait`, or `cancel`.
+
+After setup is complete, add a shipping address and start ordering:
 
 ```
 $ clishop search "wireless headphones"
@@ -179,6 +203,11 @@ clishop-mcp              # If installed globally
 npx -y clishop --mcp     # Without installing
 ```
 
+The MCP onboarding tools now follow the same resumable setup session model:
+
+- `setup` starts the session and returns `setup_id` plus `setup_url`
+- `setup_status` checks progress and finalizes auth when setup is complete
+
 See the [MCP setup guides](https://clishop.ai/docs#mcp-overview) for VS Code, Claude Desktop, Cursor, and Windsurf configuration.
 
 ---

package/dist/index.js

@@ -55,6 +55,7 @@ function registerAuthCommands(program2) {
   program2.command("whoami").description("Show the currently logged-in user").action(async () => {
     if (!await isLoggedIn()) {
       console.log(chalk.yellow("Not set up yet. Run: clishop setup"));
+      console.log(chalk.dim("For agent runners, use: clishop setup start --email <email> --json"));
       return;
     }
     const user = await getUserInfo();
@@ -1094,8 +1095,8 @@ async function runSetupWizard(emailArg, { json = false } = {}) {
   console.log();
   console.log(chalk4.bold.cyan("      W E L C O M E   T O   C L I S H O P"));
   console.log(chalk4.dim("      Order anything from your terminal."));
-  console.log(chalk4.dim(`      npm:   v${"1.5.0"}`));
-  console.log(chalk4.dim(`      Build: ${"2026-04-04T19:19:52.565Z"}`));
+  console.log(chalk4.dim(`      npm:   v${"1.5.1"}`));
+  console.log(chalk4.dim(`      Build: ${"2026-04-04T20:33:18.769Z"}`));
   console.log();
   divider(chalk4.cyan);
   console.log();
@@ -3171,6 +3172,7 @@ function registerStatusCommand(program2) {
     try {
       if (!await isLoggedIn()) {
         console.log(chalk11.yellow("\nNot set up yet. Run: clishop setup\n"));
+        console.log(chalk11.dim("For agent runners, use: clishop setup start --email <email> --json\n"));
         return;
       }
       const spinner = ora8("Fetching account overview...").start();
@@ -4288,10 +4290,11 @@ function registerDoctorCommand(program2) {
 
 // src/index.ts
 var program = new Command();
-program.name("clishop").version("1.5.0").description(
+program.name("clishop").version("1.5.1").description(
   chalk16.bold("CLISHOP") + ` \u2014 Order anything from your terminal.
 
-  Run 'clishop setup' to get started with a single payment link.
+  Run 'clishop setup' for the human-friendly flow, or
+  'clishop setup start --email <email> --json' for agent-safe setup.
   Use agents to set safety limits, addresses, and payment methods.
   The "default" agent is used when no agent is specified.`
 ).option("--agent <name>", "Use a specific agent for this command").hook("preAction", (thisCommand) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clishop",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "mcpName": "io.github.StefDCL/clishop",
   "description": "CLISHOP — Order anything from your terminal",
   "main": "dist/index.js",