@vibebrowser/mcp 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,132 +0,0 @@
1
- ---
2
- name: vibe-local-browser
3
- description: Control the user's local browser through the Vibe Browser CLI bridge. Use this when the task must run against the user's real Vibe-connected browser session, tabs, cookies, or installed extensions.
4
- metadata:
5
- {
6
- "openclaw":
7
- {
8
- "emoji": "🌐",
9
- "requires":
10
- {
11
- "bins": ["npx"],
12
- "env": ["VIBE_EXTENSION_UUID"],
13
- },
14
- },
15
- }
16
- ---
17
-
18
- # Vibe Local Browser
19
-
20
- Use the `vibebrowser-cli` command when the user wants OpenClaw to drive their real local browser through the Vibe extension.
21
-
22
- Prefer this skill when the task depends on:
23
-
24
- - the user's real browser profile
25
- - existing logged-in sessions
26
- - local tabs already open on the user's machine
27
- - browser extensions or stored site state
28
-
29
- Do not use this skill for OpenClaw tenant cloud browsing.
30
-
31
- ## Required environment
32
-
33
- The shell running OpenClaw must have:
34
-
35
- ```bash
36
- export VIBE_EXTENSION_UUID="<extension-uuid>"
37
-
38
- # Optional if you use a custom relay URL.
39
- # export VIBE_RELAY_URL="wss://relay.api.vibebrowser.app"
40
-
41
- # Optional compatibility label. Vibe always targets the real local browser path.
42
- # export VIBE_BROWSER_PROFILE="user"
43
- ```
44
-
45
- ## Command form
46
-
47
- Prefer this exact command pattern:
48
-
49
- ```bash
50
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json <subcommand> ...
51
- ```
52
-
53
- If the package is already installed locally, you can use:
54
-
55
- ```bash
56
- vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json <subcommand> ...
57
- ```
58
-
59
- If you set `VIBE_RELAY_URL`, append:
60
-
61
- ```bash
62
- --relay-url "$VIBE_RELAY_URL"
63
- ```
64
-
65
- ## Safe operating rules
66
-
67
- - Prefer `browser tabs` or `browser snapshot` before acting.
68
- - Use `browser open <url>` to create a fresh page when possible.
69
- - Use `browser evaluate --fn ...` only for simple compatibility-safe expressions such as:
70
- - `() => 21 + 21`
71
- - `() => document.title`
72
- - `() => location.href`
73
- - `() => location.hostname`
74
- - `() => location.origin`
75
- - Avoid destructive actions unless the user explicitly asks.
76
- - If the CLI returns a connection error, report it clearly and stop guessing.
77
- - The OpenClaw-compatible `--browser-profile` flag is accepted by the CLI, but Vibe always targets the user's real browser path rather than an isolated managed browser.
78
-
79
- ## Common commands
80
-
81
- Status:
82
-
83
- ```bash
84
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json status
85
- ```
86
-
87
- List pages:
88
-
89
- ```bash
90
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json tabs
91
- ```
92
-
93
- Open a new page:
94
-
95
- ```bash
96
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json open https://example.com
97
- ```
98
-
99
- Take the default AI snapshot:
100
-
101
- ```bash
102
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json snapshot
103
- ```
104
-
105
- Take the ARIA / interactive snapshot:
106
-
107
- ```bash
108
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json snapshot --format aria --interactive
109
- ```
110
-
111
- Click and type using OpenClaw-style refs:
112
-
113
- ```bash
114
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json click 12
115
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json type 23 "hello" --submit
116
- ```
117
-
118
- Evaluate JavaScript:
119
-
120
- ```bash
121
- npx -y --package @vibebrowser/mcp vibebrowser-cli --remote "$VIBE_EXTENSION_UUID" --json evaluate --fn '() => document.title'
122
- ```
123
-
124
- ## Success criteria
125
-
126
- A successful run usually looks like:
127
-
128
- 1. confirm the relay is reachable
129
- 2. list current tabs or create a fresh one
130
- 3. navigate or snapshot if needed
131
- 4. evaluate `document.title` or `location.href` to verify the result
132
- 5. summarize what happened for the user