# Kortix Chrome

Kortix in Chrome: the Chrome extension that connects a user's own browser to Kortix so...

- Repository: https://github.com/kortix-ai/suna (20345 stars)
- Category: Testing
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kortix-ai/suna --skill kortix-chrome -g -a claude-code -y`
Codex: `npx skills add kortix-ai/suna --skill kortix-chrome -g -a codex -y`
Cursor: `npx skills add kortix-ai/suna --skill kortix-chrome -g -a cursor -y`
Gemini CLI: `npx skills add kortix-ai/suna --skill kortix-chrome -g -a gemini-cli -y`

## Description

Kortix in Chrome: the Chrome extension that connects a user's own browser to Kortix so a session's sandbox drives it over CDP (`kortix chrome use` + `agent-browser --cdp 9333`). Load WHENEVER you touch apps/chrome-extension, apps/api/src/chrome, the kortixd browser bridge, `kortix browser` CLI, the browsers settings tab or connect modal, the kortix-chrome managed skill, or when you build, load, test, publish or debug the extension.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Kortix in Chrome

A user installs the **Kortix** Chrome extension and signs in. From then on, any
of their sessions can drive that browser, with its logins, from the cloud
sandbox. The agent runs `kortix chrome use`, then plain `agent-browser --cdp
9333 …` commands. The browser is a separate product from the agent tunnel
("Your computer"). It shares no code path, credential or UI with it.

The wire contract is [references/protocol.md](references/protocol.md). Read it
before you change any part. A wire change edits that file in the same commit.

## Where the code lives

| Part | Path |
|---|---|
| Extension (MV3) | `apps/chrome-extension` |
| API: control socket, REST, attach | `apps/api/src/chrome/` |
| Tables | `chrome_connections`, `chrome_grants`, `chrome_attachments` |
| Sandbox bridge + CDP endpoint | `apps/kortix-sandbox-agent-server/src/**/chrome*` |
| CLI | `apps/cli/src/commands/chrome.ts` |
| Agent skill (served to sessions) | `packages/starter/templates/managed/skills/kortix-chrome/SKILL.md` |
| SDK hooks | `packages/sdk/src/**/chrome*` (`useChromeConnections`, `useUpdateChromeConnection`, `useDeleteChromeConnection`) |
| Web | `apps/web/src/features/chrome/`, sidebar row `project-chrome-nav.tsx`, settings tab `chrome` (`/settings/chrome`) |

## How one action travels

The rest: https://github.com/kortix-ai/suna/blob/HEAD/.agents/skills/kortix-chrome/SKILL.md