---
name: browser-vm
description: Plan and provision the future Linux browser VM executor for Clawdie. Use when defining or creating the Debian Trixie browser VM base image, choosing between base-tmux, browser, xfce, i3, or kde profiles, sizing RAM/disk, naming clones, or designing ZFS snapshot and clone workflows for GUI/browser automation.
---

# Browser VM

Use this skill for the future Linux VM executor.

This skill is for the Warden browser VM runtime, not for FreeBSD jail provisioning.

## Scope

This skill covers:

- Debian Trixie 13 VM base image planning
- profile selection
- RAM and disk defaults
- clone naming
- ZFS-backed VM dataset layout
- snapshot and clone strategy

This skill does not replace:

- `warden-bootstrap` for jail provisioning
- `warden-zfs` for general jail dataset layout
- `nginx-glasspane` for the operator web surface

## Canonical defaults

- runtime: `linux-vm`
- distro: Debian Trixie 13
- RAM: `4G`
- disk: `30G`
- default source image: `base-tmux`

## Supported profiles

- `base-tmux`
- `browser`
- `xfce`
- `i3`
- `kde`

## Workflow

1. Read `references/profile-matrix.md`
2. Read `references/resource-defaults.md`
3. Read `references/zfs-layout.md`
4. If you need snapshot guidance, read `references/snapshot-strategy.md`
5. Prefer the scripts in `scripts/` for canonical naming and plan output
