# Ubuntu Browser Session

> Use when a task needs a reusable Ubuntu Server browser session with optional assisted login and host-side page inspection.

- Skill: `dvcrn/ubuntu-browser-session` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add dvcrn/ubuntu-browser-session`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/ubuntu-browser-session/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/ubuntu-browser-session

---


# Ubuntu Browser Session

Reusable browser-session workflow for Ubuntu Server hosts.

## When To Use

- Open or inspect a page from a headless Ubuntu Server host
- Reuse a previously verified browser session instead of starting fresh
- Ask the user for one bounded round of assisted login when local reuse is not enough
- Inspect visible page state from the host after the browser session is ready

## Workflow

Preferred entrypoint:

```bash
{baseDir}/scripts/open-protected-page.sh --url 'https://target.example' --session-key default
```

Use lower-level helpers only when you need to inspect or repair an individual stage:

```bash
{baseDir}/scripts/session-manifest.sh select --origin 'https://target.example'
{baseDir}/scripts/browser-runtime.sh verify --origin 'https://target.example' --session-key default
{baseDir}/scripts/assisted-session.sh start --url 'https://target.example' --origin 'https://target.example' --session-key default
```

## Environment Requirements

```bash
command -v python3
command -v curl
command -v jq
command -v Xvfb
command -v x11vnc
command -v websockify
command -v google-chrome || command -v chromium || command -v chromium-browser
```

## Key Files

- `scripts/open-protected-page.sh`: high-level session orchestration
- `scripts/browser-runtime.sh`: browser runtime management
- `scripts/assisted-session.sh`: assisted browser session overlay
- `scripts/session-manifest.sh`: session record management
- `scripts/cdp-eval.py`: host-side page inspection helper

See also:

- `references/session-manifest.md`
- `references/assisted-session-flow.md`