kroki 1.0.0 → 1.0.2

package/README.md

@@ -1,7 +1,7 @@
 # Kroki CLI
 
-> **Browser Automation & AI Agent Bridge for Google Chrome & Dolphin{anty}**  
-> Control live browser tabs, run deterministic workflows, and extract web data from your terminal or any AI Coding Agent (Antigravity, Cursor, Claude Code, Windsurf).
+> **Browser Automation & AI Agent Bridge for Google Chrome**  
+> Control live browser tabs, run deterministic workflows, and extract web data from your terminal or AI Coding Agents (Antigravity, Cursor, Claude Code, Windsurf).
 
 [![npm version](https://img.shields.io/npm/v/kroki.svg)](https://www.npmjs.com/package/kroki)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -11,78 +11,40 @@
 
 ## ⚡ Quick Start
 
-No installation required. You can run it directly with `npx`:
+No installation required — run directly with `npx`:
 
 ### 1. Pair with your browser profile
-
-Go to your [Kroki Devices Dashboard](https://kroki.one/devices) and click **"Скопировать код для AI"** next to the active Chrome or Dolphin{anty} profile you want to control.
-
+1. Open [https://kroki.ai/#/devices](https://kroki.ai/#/devices) *(Ultra plan required)*.
+2. Click **"Скопировать код для AI"** next to your active browser profile.
+3. Pair:
 ```bash
 npx kroki pair <YOUR_PAIRING_CODE>
 ```
 
-```text
-Connecting to profile [Dolphin WB-Bot]...
-✔ Successfully paired with "Dolphin WB-Bot".
-```
-
-### 2. Send an AI task to the live browser
-
+### 2. Control browser or run workflows
 ```bash
-npx kroki "open wildberries.ru, search for 'iPhone 16 cases' and list the top 5 prices"
-```
-
-Kroki's built-in Planner & Navigator subagent will navigate to the page, interact with elements, extract the requested information, and stream the result back to your terminal.
+# Autonomous browser task (Planner + Navigator)
+npx kroki "open github.com/trending and list the top 3 repositories"
 
-### 3. Run a saved workflow
-
-```bash
+# Run a saved deterministic workflow
 npx kroki run "Export Leads" '{"query": "CTO", "limit": 20}'
-```
-
----
-
-## 📦 Global Installation (Optional)
-
-If you prefer using `kroki` without typing `npx` every time:
 
-```bash
-npm install -g kroki
-```
-
-Now you can just run:
-
-```bash
-kroki pair <CODE>
-kroki "scrape the current page"
-kroki run "My Workflow"
+# Check status or disconnect
+npx kroki status
+npx kroki clear
 ```
 
 ---
 
 ## 🤖 Using with AI Agents (Antigravity, Claude Code, Cursor)
 
-Kroki CLI works out-of-the-box with AI pair-programming agents.
-
-### In Antigravity CLI
-
-Whenever you mention **kroki** in the chat, the agent automatically knows how to use this CLI:
-
-> **You:** `kroki pair kroki_eyJh...`  
-> **Agent:** Pairs with the specified profile and confirms readiness.  
->  
-> **You:** `kroki найди на Avito Mac mini M4 и выпиши самые дешевые цены`  
-> **Agent:** Executes `kroki "<task>"`, waits for Kroki in the browser to finish, and summarizes the findings.
-
-### In Cursor / Claude Code
-
-Add the following to your agent prompt or rule file (`.cursorrules` or `CLAUDE.md`):
+Add the following to your project's agent instructions (`.cursorrules`, `CLAUDE.md`, or system prompt):
 
 ```markdown
-When the user requests live browser interaction or running Kroki workflows:
-1. Ensure the profile is paired: run `npx kroki status`. If not paired, ask the user for their pairing code from https://kroki.one/devices.
-2. Pair via `npx kroki pair <CODE>`.
-3. Dispatch tasks via `npx kroki "<task>"` or workflows via `npx kroki run "<workflow>" '[vars]'`.
+When asked to automate the browser or run Kroki workflows:
+1. Check pairing: `npx kroki status`. If not paired, ask user for pairing code from https://kroki.ai/#/devices.
+2. Pair: `npx kroki pair <CODE>`.
+3. Execute: `npx kroki "<task>"` or `npx kroki run "<workflow>" '[vars]'`.
 ```
 
 ---
@@ -91,24 +53,14 @@ When the user requests live browser interaction or running Kroki workflows:
 
 | Command | Description |
 | :--- | :--- |
-| `npx kroki pair <code_from_devices>` | Connect to a specific browser profile (Chrome or Dolphin{anty}) |
-| `npx kroki "<browser_task>"` | Send an autonomous agent task to the active browser profile |
-| `npx kroki run "<workflow_name>" [json]` | Execute a saved Kroki deterministic workflow |
-| `npx kroki status` | View the currently paired profile and device info |
+| `npx kroki pair <CODE>` | Pair with active browser profile |
+| `npx kroki "<task>"` | Execute browser task via autonomous Planner & Navigator |
+| `npx kroki run "<name>" [json]` | Execute a saved Kroki deterministic workflow |
+| `npx kroki status` | View active paired profile and device info |
 | `npx kroki clear` | Clear active pairing session |
-| `npx kroki help` | Show usage options and help |
-
----
-
-## 🔒 Security Architecture
-
-- **Zero Global Credentials**: Pairing codes are session-bound and scoped strictly to your selected browser window (`targetDeviceId`).
-- **Confirmation Gate**: The extension prompts you for confirmation on your computer when a connection attempt is made.
-- **Ultra Plan Scoped**: Cloud control channels require an active Ultra entitlement.
-- **Pure Native Node.js**: Zero third-party npm dependencies. Clean, audited, and lightweight.
 
 ---
 
 ## 📄 License
 
-MIT © [Kroki Team](https://kroki.one)
+MIT © [Kroki Team](https://kroki.ai)

package/bin/kroki.js

@@ -4,11 +4,11 @@
  * Kroki CLI — Control Kroki browser automation from terminal & AI agents.
  * Zero external dependencies. Uses native Node.js 18+ WebSocket & Fetch.
  *
- * https://kroki.one
+ * https://kroki.ai
  */
 
 import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
-import { resolve, join } from 'node:path';
+import { join } from 'node:path';
 import { homedir } from 'node:os';
 
 const CONFIG_DIR = join(homedir(), '.kroki');
@@ -36,7 +36,7 @@ function decodePairingCode(code) {
     return parsed;
   } catch {
     throw new Error(
-      'Invalid Kroki pairing code.\nPlease copy a valid code from your Kroki Devices panel (https://kroki.one/devices).',
+      'Invalid Kroki pairing code.\nPlease get a valid code from your Kroki Devices panel: https://kroki.ai/#/devices',
     );
   }
 }
@@ -191,9 +191,17 @@ class RealtimeConnection {
 
 async function pairCommand(code) {
   if (!code) {
-    console.error('Error: Pairing code required.\nUsage: npx kroki pair <kroki_code>\n');
-    console.error('Get your code from: https://kroki.one/devices');
-    process.exit(1);
+    console.log(`
+\x1b[1mKroki Pairing\x1b[0m
+Requires an active \x1b[33mUltra\x1b[0m plan.
+
+1. Log in at \x1b[36mhttps://kroki.ai/#/devices\x1b[0m
+2. Find your active browser profile
+3. Click \x1b[32m"Скопировать код для AI"\x1b[0m
+4. Run:
+   \x1b[33mnpx kroki pair <YOUR_CODE>\x1b[0m
+`);
+    process.exit(0);
   }
 
   const payload = decodePairingCode(code);
@@ -220,8 +228,8 @@ async function taskCommand(taskText) {
   const session = getActiveSession();
   if (!session) {
     console.error('\x1b[31mError: Not paired.\x1b[0m');
-    console.error('First pair with your browser profile:\n  \x1b[33mnpx kroki pair <CODE_FROM_DEVICES>\x1b[0m\n');
-    console.error('Get your code from: https://kroki.one/devices');
+    console.error('Pair first with code from https://kroki.ai/#/devices (Ultra plan required):');
+    console.error('  \x1b[33mnpx kroki pair <YOUR_CODE>\x1b[0m\n');
     process.exit(1);
   }
 
@@ -262,7 +270,8 @@ async function workflowCommand(nameOrId, varsJson) {
   const session = getActiveSession();
   if (!session) {
     console.error('\x1b[31mError: Not paired.\x1b[0m');
-    console.error('Pair first with:\n  \x1b[33mnpx kroki pair <CODE>\x1b[0m\n');
+    console.error('Pair first with code from https://kroki.ai/#/devices (Ultra plan required):');
+    console.error('  \x1b[33mnpx kroki pair <YOUR_CODE>\x1b[0m\n');
     process.exit(1);
   }
 
@@ -309,36 +318,28 @@ async function workflowCommand(nameOrId, varsJson) {
 function statusCommand() {
   const session = getActiveSession();
   if (!session) {
-    console.log('\x1b[33mStatus: Not paired with any browser profile.\x1b[0m');
-    console.log('Pair with:\n  npx kroki pair <CODE_FROM_DEVICES>');
-  } else {
-    console.log('\x1b[32mStatus: Paired and Active\x1b[0m');
-    console.log(`Profile:   ${session.deviceName || session.deviceId}`);
-    console.log(`Device ID: ${session.deviceId}`);
-    console.log(`Platform:  ${session.platform || 'unknown'}`);
-    console.log(`Paired At: ${new Date(session.pairedAt).toLocaleString()}`);
+    console.log('No active paired profile.');
+    console.log('To pair, get a code from https://kroki.ai/#/devices and run:');
+    console.log('  npx kroki pair <CODE>');
+    return;
   }
+  console.log(`\x1b[32m✔ Paired\x1b[0m with "${session.deviceName || session.deviceId}" (${session.platform || 'browser'})`);
+  console.log(`  Device ID: ${session.deviceId}`);
 }
 
 function helpCommand() {
   console.log(`
-\x1b[1mKroki CLI\x1b[0m — Control Kroki browser automation from terminal & AI agents
+\x1b[1mKroki CLI\x1b[0m — Browser Automation & AI Agent Bridge for Google Chrome
 
 \x1b[1mUsage:\x1b[0m
-  npx kroki pair <code_from_devices>       Pair with a browser profile (Chrome / Dolphin{anty})
-  npx kroki "<browser_task>"              Send an AI task to the paired browser
-  npx kroki run "<workflow_name>" [json]  Execute a deterministic workflow by name
-  npx kroki status                        Show currently paired profile
-  npx kroki clear                         Clear active pairing session
-  npx kroki help                          Show this help message
-
-\x1b[1mExamples:\x1b[0m
-  npx kroki pair kroki_eyJh...
-  npx kroki "find top 5 mechanical keyboards on Amazon and return prices"
-  npx kroki run "Export Leads" '{"limit": 50}'
-
-\x1b[1mDocs & Dashboard:\x1b[0m
-  https://kroki.one/devices
+  npx kroki pair <CODE>                   Pair with a browser profile (from https://kroki.ai/#/devices)
+  npx kroki "<task>"                      Send an AI task to the live browser
+  npx kroki run "<workflow>" [json]       Execute a saved workflow
+  npx kroki status                        View paired profile and status
+  npx kroki clear                         Disconnect active pairing session
+
+\x1b[1mDashboard:\x1b[0m
+  https://kroki.ai/#/devices
 `);
 }
 
@@ -356,6 +357,10 @@ switch (first) {
     });
     break;
 
+  case 'status':
+    statusCommand();
+    break;
+
   case 'run':
   case 'workflow':
     workflowCommand(rawArgs[1], rawArgs[2]).catch(e => {
@@ -364,10 +369,6 @@ switch (first) {
     });
     break;
 
-  case 'status':
-    statusCommand();
-    break;
-
   case 'clear':
   case 'disconnect':
     clearActiveSession();
@@ -381,10 +382,10 @@ switch (first) {
     break;
 
   default:
-    // If user ran `npx kroki "do something..."` directly
     taskCommand(rawArgs.join(' ')).catch(e => {
       console.error(`\x1b[31mError:\x1b[0m ${e.message}`);
       process.exit(1);
     });
     break;
 }
+

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "kroki",
-  "version": "1.0.0",
-  "description": "Kroki Browser Automation CLI — Control Chrome & Dolphin{anty} from terminal and AI agents",
+  "version": "1.0.2",
+  "description": "Kroki Browser Automation CLI — Control Chrome from terminal and AI agents",
   "keywords": [
     "kroki",
     "browser-automation",
     "ai-agent",
     "antigravity",
-    "dolphin-anty",
     "chrome",
     "mcp",
     "cli"
@@ -16,7 +15,7 @@
   "license": "MIT",
   "type": "module",
   "bin": {
-    "kroki": "./bin/kroki.js"
+    "kroki": "bin/kroki.js"
   },
   "files": [
     "bin",
@@ -33,5 +32,5 @@
   "bugs": {
     "url": "https://github.com/one-focus/kroki-cli/issues"
   },
-  "homepage": "https://kroki.one"
+  "homepage": "https://kroki.ai"
 }