# Browser Visible

> Use this skill when the user needs to control the browser launch mode for browser. By default browser is managed by Playwright and opens no debugging port (pass an explicit `cdp_port` to let another local tool attach); `headed` controls whether the window is visible, and `private_mode` is kept for backward compatibility and no longer changes the default.

- Skill: `agentscope-ai/browser-visible-3` (Agent Skill)
- Install (CLI): `npx get-skill add agentscope-ai/browser-visible-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentscope-ai/browser-visible-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentscope-ai (https://skillmd.com/u/agentscope-ai)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/agentscope-ai/browser-visible-3

---


> **Deprecated:** This reference supports the stable `browser` implementation.
> hatch. Prefer the unified `browser` tool when experimental mode is enabled.

# Browser Launch Modes

`browser.start` launch modes:

- Default: Playwright-managed, no debugging port
- `cdp_port=N`: managed CDP, opens a local debugging port so other local tools can attach (see the browser_cdp skill)
- `private_mode=true`: same as the default, kept for backward compatibility

Parameter meanings:

- `headed`: whether to display the browser window
- `private_mode`: kept for backward compatibility; it no longer changes the launch mode

The two parameters are independent and can be freely combined.

## Common Usage

Default launch:
```json
{"action": "start"}
```

Open a visible window:
```json
{"action": "start", "headed": true}
```

## `private_mode`

Already the default behavior — do not set it. The parameter is kept only so that older calls keep working, and passing it together with `cdp_port` is rejected.

## Notes

- The default is Playwright-managed with no debugging port
- The launch mode is entirely determined by the call parameters
- Managed CDP requires Chrome / Chromium / Edge to be installed locally
- When the user manually operates the visible browser, the idle timer may not be refreshed
- `private_mode` is an explicit parameter for each `start` call and is not persisted
- If a browser is already running, you must `stop` it and then `start` again to switch launch modes or window visibility
- Visible mode occupies the desktop and requires a graphical environment; it may not work on servers or headless environments

