Chrome Extension

chrome(action=...) controls the user’s real Chrome browser via Extension + Native Messaging, leveraging existing login sessions.

Overview

The Chrome tool is the highest-layer browser interaction tool — it connects to the user’s real Chrome browser and can operate on authenticated websites. All write operations follow a 4-level confirmation policy.

Architecture

Available Actions

Action	Description	Key Params
`list_tabs`	List all open tabs	—
`claim_tab`	Take control of a tab	`tab_id`
`navigate`	Go to URL	`url`, `new_tab`
`screenshot`	Tab screenshot	`full_page`
`click`	Click element	`selector`/`ref`
`type`	Type text	`selector`/`ref`, `text`
`fill`	Set value	`selector`/`ref`, `text`
`extract`	Extract page content	`selector`
`scroll`	Scroll	`direction`, `amount`
`press_key`	Press key	`key`
`execute_js`	Run JavaScript	`code`
`snapshot`	Get Accessibility Tree	`selector`
`browser_auth`	Credential operations	`auth_action`, `auth_uri`

Tab Lifecycle

# 1. Discover
chrome(action="list_tabs")

# 2. Claim
chrome(action="claim_tab", tab_id="tab1")

# 3. Interact
chrome(action="extract", selector="main")

# 4. Release (automatic)

Confirmation Policy (4 Levels)

Level	When	Examples
Hand-Off	STOP and ask user	Password changes, bypassing security, large financial ops
Confirmation	Ask before proceeding	CAPTCHAs, irreversible deletes, creating credentials
Pre-Approval	Proceed if pre-approved	Save passwords, non-critical accounts, non-sensitive settings
Not Required	Proceed freely	Read-only browsing, cookie banners, screenshots

Security Constraints

❌ Never return cookies, tokens, or session data
❌ Never store credentials outside browser_auth
❌ Never navigate to malicious URLs
❌ Never bypass 2FA
❌ Never access chrome:// pages
❌ Never modify browser settings

browser_auth

Secure credential management — sensitive data never leaves the Extension:

# Check if credentials exist (returns boolean, NOT the password)
chrome(action="browser_auth", auth_action="get_credentials", auth_uri="https://github.com")

# Prompt user to save (Extension shows native popup)
chrome(action="browser_auth", auth_action="store_credentials", auth_uri="https://github.com")

# Clear session
chrome(action="browser_auth", auth_action="clear_session", auth_uri="https://github.com")

Prerequisites

Profy Desktop running
Profy Browser Extension installed and enabled
Chrome browser running

Browser Automation 3D & Visualization

Get Started

Core Concepts

Chat with Experts

Creation & Automation

Plugin Tools

Memory & Personalization

Marketplace & Content

IM Channels

Account & Billing

Team

How It Works

Help

Chrome Extension

Chrome Extension

Overview

Architecture

Available Actions

Tab Lifecycle

Confirmation Policy (4 Levels)

Security Constraints

browser_auth

Prerequisites

​Chrome Extension

​Overview

​Architecture

​Available Actions

​Tab Lifecycle

​Confirmation Policy (4 Levels)

​Security Constraints

​browser_auth

​Prerequisites

Chrome Extension

Overview

Architecture

Available Actions

Tab Lifecycle

Confirmation Policy (4 Levels)

Security Constraints

browser_auth

Prerequisites