Kroki CLI

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).

⚡ Quick Start

No installation required — run directly with npx:

1. Pair with your browser profile

1. Open https://kroki.ai/#/devices (Ultra plan required).
2. Click "Скопировать код для AI" next to your active browser profile.
3. Pair:

npx kroki pair <YOUR_PAIRING_CODE>

2. Control browser or run workflows

# Autonomous browser task (Planner + Navigator)
npx kroki "open github.com/trending and list the top 3 repositories"

# Run a saved deterministic workflow
npx kroki run "Export Leads" '{"query": "CTO", "limit": 20}'

# Check status or disconnect
npx kroki status
npx kroki clear

🤖 Using with AI Agents (Antigravity, Claude Code, Cursor)

Add the following to your project's agent instructions (.cursorrules, CLAUDE.md, or system prompt):

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]'`.

🛠 Commands Reference

| Command | Description | | :--- | :--- | | 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 |

📄 License

MIT © Kroki Team