# Browser Preflight

> Pre-flight resource check before launching Browser Subagent. Use when the agent is about to start a browser session, automate a web page, or run any browser_subagent task. Prevents crashes on low-resource machines by checking RAM, disk space, and zombie processes.

- Skill: `giauphan/browser-preflight` (Agent Skill)
- Install (CLI): `npx skillmds@latest add giauphan/browser-preflight`
- Raw SKILL.md: https://api.skillmd.com/api/skills/giauphan/browser-preflight/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: giauphan (https://skillmd.com/u/giauphan)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/giauphan/browser-preflight

---


# Browser Pre-Flight Check

Run this skill **before every Browser Subagent launch**. If any check fails, warn the user and do NOT launch the browser.

## Step 1: Check Available RAM

```bash
echo "=== RAM Check ==="
free -h | grep Mem
AVAIL_MB=$(free -m | awk '/Mem:/ {print $7}')
echo "Available: ${AVAIL_MB}MB"
if [ "$AVAIL_MB" -lt 2048 ]; then
  echo "⛔ WARNING: Less than 2GB RAM available. Browser launch is RISKY."
  echo "ACTION: Clean up processes or warn user before proceeding."
else
  echo "✅ RAM OK (>2GB available)"
fi
```

## Step 2: Check Disk Space

```bash
echo "=== Disk Check ==="
AVAIL_GB=$(df -BG . | awk 'NR==2 {print $4}' | tr -d 'G')
echo "Available: ${AVAIL_GB}GB"
if [ "$AVAIL_GB" -lt 5 ]; then
  echo "⛔ WARNING: Less than 5GB disk space. Browser artifacts will fill up fast."
  echo "ACTION: Run browser-heavy-cleanup skill first."
else
  echo "✅ Disk OK (>5GB available)"
fi
```

## Step 3: Check Existing Zombie Processes

```bash
echo "=== Zombie Chrome Check ==="
CHROME_COUNT=$(pgrep -c -f "chromium|chrome" 2>/dev/null || echo "0")
echo "Existing chrome processes: $CHROME_COUNT"
if [ "$CHROME_COUNT" -gt 3 ]; then
  echo "⚠️ WARNING: $CHROME_COUNT chrome processes already running. Cleaning up first..."
  pkill -f "chromium.*--headless" 2>/dev/null || true
  pkill -f "chrome.*--automation" 2>/dev/null || true
  echo "✅ Cleaned up old chrome processes"
else
  echo "✅ No zombie chrome processes"
fi
```

## Step 4: Check Existing Browser Tabs

> If a browser instance is already running, audit open tabs to prevent duplicates.

```bash
echo "=== Tab Audit ==="
if pgrep -f "chromium|chrome" > /dev/null 2>&1; then
  echo "⚠️ Browser already running — existing tabs may be present."
  echo "ACTION: Include tab management rules in Browser Subagent task prompt."
  echo "ACTION: Check for duplicate URLs before navigating."
else
  echo "✅ No existing browser — clean slate."
fi
```

## Decision

- If ANY check shows ⛔: **DO NOT** launch browser. Warn user.
- If all checks show ✅: Proceed with browser launch.
- If browser already running (Step 4 ⚠️): Include tab management instructions from `skills/browser-tab-manager/SKILL.md`.