va-preview

name	va-preview
description	Exposes a local dev server or HTML file as a live preview via a shareable public URL, enabling browser and mobile device testing. Use after starting a dev server or creating HTML/CSS/JS files, or when the user asks to "preview this", "show me on my phone", "share a preview link", "open in browser", or "mobile preview". Only available when the VibeAround MCP server is connected.

VibeAround Live Preview

Exposes a local dev server or static files as a live preview via a shareable URL, so the user can view the result in their browser or on a mobile device.

When to Use

• After starting a dev server (next dev, vite, python -m http.server, etc.)
• After creating HTML/CSS/JS files the user should see
• The user asks to "show me", "preview", "let me see it on my phone", or "share a preview link"

Proactive behavior: After starting a dev server or creating a web artifact, ask the user if they'd like a preview link (e.g. "Want me to generate a preview link so you can see it on your phone?"). Only call preview after the user confirms.

Prerequisites

The VibeAround MCP server must be connected (server name: vibearound). If not available, tell the user to start the VibeAround desktop app.

Steps

1. Ensure the server is listening

• Verify the port is free: lsof -i :<port> should return nothing before starting
• Wait for the server's "Listening on..." message before proceeding
• Use --host 0.0.0.0 when available for broader network compatibility

2. Resolve the session ID

Use the /va-session skill to get the current session ID.

3. Call preview

Tool: preview
Server: vibearound
Arguments:
  port: <the port your server is running on>
  cwd: "<current working directory>"
  session_id: "<session_id from step 2>"  (pass if available)
  title: "<short description of what you built>"  (optional)

If the workspace is not registered, call register_workspace with the cwd first, then retry.

4. Present BOTH links to the user

The tool returns an Owner link and a Share link. Always show both in this format:

Preview 已就绪：
- 你的预览: <owner_url>
- 分享链接: <share_url>（10 分钟有效）

Or in English:

Preview ready:
- Owner: <owner_url>
- Share: <share_url> (expires in 10 min)

Never omit either link. The owner link is permanent (requires browser pairing). The share link is temporary and needs no auth — ideal for sending to others or testing on mobile.

Error Handling

• MCP server not available: The VibeAround desktop app may not be running.
• Workspace not registered: Call register_workspace first, then retry.
• Port in use: Check with lsof -i :<port> and choose a different port.