feat: add Kortix Chrome Extension - Browser Operator for AI Agents

[Logrui]

Overview

This PR introduces the Kortix AI Browser Operator, a headless Chrome extension that enables Kortix AI agents to control the user's local browser.

Key Features

• Listener/Router Pattern: Receives commands from Kortix backend and executes them in the browser
• 12 Core Commands: Navigate, click, type, scroll, screenshot, extract emails, extract content, get elements, fill form, submit form, get page info, execute script
• Session Management: Unique session ID, command history tracking, extraction history
• Error Handling: Graceful error messages, timeout handling, fallback support
• Security: Manifest V3, minimal permissions, message validation ready
• Testing: Mock extension, testing utilities, example scenarios
• Documentation: 6 comprehensive guides covering installation, integration, deployment

Architecture

The extension implements a listener/router pattern similar to Manus 'My Browser':

Kortix Backend Router
    ↓
    ├─ Local Browser (Chrome Extension) ← This PR
    ├─ Sandbox Browser (Fallback)
    └─ Cloud Browser (Fallback)

Files Added

• Core Implementation (5 files): Background service worker, content script, popup UI, types, manifest
• Integration & Testing (3 files): Backend client, testing utilities, example tests
• Configuration (3 files): package.json, tsconfig.json, vite.config.ts
• Documentation (6 files): README, QUICKSTART, INTEGRATION, DEPLOYMENT, CONTRIBUTING, PROJECT_SUMMARY
• UI (2 files): Popup HTML and entry point

Total: 18 files created

Integration

Kortix backend can integrate with this extension via the BrowserRouterClient:

from kortix_browser_extension import BrowserRouterClient

client = BrowserRouterClient()
await client.initialize()

# Use in agents
emails = await client.extract_emails()
await client.navigate('https://example.com')

Testing

Testing utilities and example scenarios provided in src/testing/ for easy integration testing.

Deployment

Ready for:

1. Development testing via chrome://extensions/
2. Production deployment to Chrome Web Store
3. Integration with Kortix backend agents

Documentation

See packages/kortix-chrome-extension/README.md for complete documentation and API reference.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
suna	Error		Jan 10, 2026 7:41am

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.