# LHI Chrome Profile Utils

A professional utility for Chrome profile selection and management on macOS, designed for use with Puppeteer, MCP servers, and browser automation workflows.


Features

- 🔍 Profile Detection: Automatically detects and lists all Chrome profiles on macOS
- 🎯 Profile Selection: Interactive UI dialog for selecting Chrome profiles
- 🚀 Direct Chrome Launch: Launch Chrome directly with selected profile (recommended)
- 💾 Profile Data Export: Save profile information to JSON for later use
- 🔧 CLI Interface: Command-line tools for profile management

Installation

``bash
npm install lhi_chrome_profile_utils
`

Usage

$3

For the best user experience with full profile features (avatar, theme, bookmarks), use direct Chrome launching:

`javascript
const { spawn } = require('child_process');
const chromeProfileUtils = require('lhi_chrome_profile_utils');

// Select a profile via UI dialog
const { chromeUserDataPath, selectedProfilePath, userDataDir } = chromeProfileUtils.getSelectedProfile();

// Launch Chrome directly
const chromeArgs = [
--profile-directory=${selectedProfilePath},
--user-data-dir=${userDataDir},
'--disable-blink-features=AutomationControlled',
'https://mail.google.com'
];

const chromeProcess = spawn('/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', chromeArgs, {
detached: true,
stdio: 'ignore'
});

chromeProcess.unref();
`

$3

For automation testing (note: may not show full profile features):

`javascript
const puppeteer = require('puppeteer');
const chromeProfileUtils = require('lhi_chrome_profile_utils');

// Get Puppeteer launch options with the selected profile
const puppeteerOptions = chromeProfileUtils.getPuppeteerLaunchOptions();
const browser = await puppeteer.launch(puppeteerOptions);
`

$3

`javascript
const chromeProfileUtils = require('lhi_chrome_profile_utils');

// List all Chrome profiles
const { chromeUserDataPath, profiles } = chromeProfileUtils.listProfiles();
console.log(Found ${profiles.length} profiles);

// Select a profile via UI dialog
const selectedProfilePath = chromeProfileUtils.selectProfile(profiles);

// Save profile data to JSON
chromeProfileUtils.saveProfilesJSON({ chromeUserDataPath, profiles }, './profiles.json');
`

$3

The package can be used directly from the command line:

`bash


List all available Chrome profiles

Returns: Object with:
- chromeUserDataPath: Path to Chrome user data directory
- profiles: Array of profile objects with details (email, name, theme color, etc.)

$3

Displays a macOS dialog for profile selection.

Parameters:
- profiles: Array of profile objects from listProfiles()

Returns: String - The path of the selected profile

$3

Combines listing and selection in one step.

Returns: Object with:
- chromeUserDataPath: Path to Chrome user data directory
- selectedProfilePath: Path of the selected profile
- userDataDir: Full path to the selected profile directory

$3

Gets Puppeteer launch options for the selected Chrome profile.

Parameters:
- headless: Boolean indicating whether to run in headless mode (default: false)

Returns: Object - Puppeteer launch options with user data directory

$3

Saves profile data to a JSON file.

Parameters:
- profileData: Profile data object from listProfiles()
- outputPath: Path where to save the JSON file

Returns: Boolean` - Success status

Requirements

- macOS operating system
- Google Chrome installed
- Node.js 14.0.0 or higher

License

MIT © Lifehack Innovations LLC

---