@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.
- package/README.md +70 -2
- package/dist/browser-cli.d.ts.map +1 -1
- package/dist/browser-cli.js +767 -358
- package/dist/browser-cli.js.map +1 -1
- package/dist/browser-main.js +1 -0
- package/dist/browser-main.js.map +1 -1
- package/dist/cli.js +52 -4
- package/dist/cli.js.map +1 -1
- package/dist/connection.d.ts +14 -7
- package/dist/connection.d.ts.map +1 -1
- package/dist/connection.js +106 -21
- package/dist/connection.js.map +1 -1
- package/dist/devtools-fallback.d.ts +22 -0
- package/dist/devtools-fallback.d.ts.map +1 -0
- package/dist/devtools-fallback.js +172 -0
- package/dist/devtools-fallback.js.map +1 -0
- package/dist/relay.d.ts +23 -3
- package/dist/relay.d.ts.map +1 -1
- package/dist/relay.js +448 -103
- package/dist/relay.js.map +1 -1
- package/dist/server.d.ts +4 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +248 -12
- package/dist/server.js.map +1 -1
- package/dist/types.d.ts +27 -10
- package/dist/types.d.ts.map +1 -1
- package/docs/chrome-devtools-relay.md +7 -0
- package/docs/eval.md +101 -16
- package/docs/openclaw-local-browser.md +119 -18
- package/openclaw/vibebrowser/SKILL.md +219 -0
- package/package.json +9 -2
- package/openclaw/vibe-local-browser/SKILL.md +0 -132
|
@@ -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
|