kernel-cli

name	kernel-cli
description	Use the Kernel CLI to manage cloud browsers, apps, profiles, proxies, managed auth, API keys, projects, and organization limits. Use when installing or authenticating the CLI, looking up current command syntax, or choosing the right command group.

Kernel CLI

The Kernel CLI provides command-line access to Kernel's cloud browser platform for browser automation, serverless app deployment, and infrastructure management.

Installation

• Homebrew: brew install kernel/tap/kernel
• npm: npm install -g @onkernel/cli

Verify with kernel --version. Use kernel <command> --help as the source of truth for the installed version.

Authentication

• Preferred: Set KERNEL_API_KEY environment variable
• Fallback: Run kernel login for interactive OAuth

Quick Start

# Authenticate
export KERNEL_API_KEY=your_api_key

# Create a browser session
kernel browsers create -o json

# Run Playwright automation (use `return` to get a value back)
kernel browsers playwright execute <session_id> '
  await page.goto("https://example.com");
  return await page.evaluate(() => document.title);
'

# Take a screenshot
kernel browsers computer screenshot <session_id> --to screenshot.png

# Cleanup
kernel browsers delete <session_id>

Safe Operation

• Prefer -o json plus jq for scripts; deploy and invoke emit JSONL rather than one JSON object.