Getting Started with 10X.in Browser Extension

Getting Started with 10X.in Browser Extension

Welcome! This guide will help you get up and running in **under 10 minutes**.

---

🚀 What You'll Learn

undefined

**Total time: ~10 minutes**

---

📋 Prerequisites

Before starting, ensure you have:

undefined

---

Step 1: Install Extension (2 min)

1.1 Download

git clone https://github.com/yourusername/claudekit-browser-extension.git
cd claudekit-browser-extension

Or [download ZIP](https://github.com/yourusername/claudekit-browser-extension/archive/refs/heads/main.zip) and extract.

1.2 Load in Browser

undefined

**Verify**: Click the 10X.in icon. Popup should open showing "Connecting..."

---

Step 2: Start WebSocket Server (2 min)

2.1 Install Dependencies

cd tests
npm install

2.2 Start Server

node websocket-test-server.js

**Expected output:**

🚀 WebSocket server running on ws://localhost:3000/ws
Waiting for extension to connect...

**Verify**: Extension popup now shows "Connected ✓" (green badge)

---

Step 3: Send Your First Command (3 min)

3.1 Create Test Script

Create `test-first-command.js`:

const WebSocket = require('ws');

const ws = new WebSocket('ws://localhost:3000/ws');

ws.on('open', () => {
  console.log('✅ Connected to extension\n');

  // Navigate to Example.com
  console.log('📍 Sending NAVIGATE command...');
  ws.send(JSON.stringify({
    type: 'browser-command',
    payload: {
      id: 'cmd-1',
      action: 'NAVIGATE',
      url: 'https://example.com'
    }
  }));
});

ws.on('message', (data) => {
  const message = JSON.parse(data);
  console.log('📨 Received:', message);

  if (message.type === 'command-result') {
    console.log('\n✅ Command executed successfully!');
    ws.close();
  }
});

ws.on('close', () => {
  console.log('👋 Disconnected');
  process.exit(0);
});

3.2 Run Script

node test-first-command.js

**What happens:**

undefined

**Expected output:**

✅ Connected to extension

📍 Sending NAVIGATE command...
📨 Received: { type: 'extension-connected', payload: {...} }
📨 Received: { type: 'command-result', commandId: 'cmd-1', success: true }

✅ Command executed successfully!
👋 Disconnected

**Congratulations! You've sent your first browser automati