@vercel/next-browser 0.1.2 → 0.1.3

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.
Files changed (2) hide show
  1. package/README.md +33 -13
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -10,25 +10,45 @@ Built for agents. An LLM can't read a DevTools panel, but it can run
10
10
  command is a stateless one-shot against a long-lived browser daemon, so an
11
11
  agent loop can fire them off without managing browser lifecycle.
12
12
 
13
- ## Install
13
+ ## Getting started
14
14
 
15
- ```bash
16
- pnpm add -g @vercel/next-browser
17
- ```
15
+ You don't install or run this directly. Your agent does.
18
16
 
19
- Requires Node `>=20`.
17
+ 1. **Add the skill to your project.** From your Next.js repo:
18
+
19
+ ```bash
20
+ npx skills add vercel-labs/next-browser
21
+ ```
22
+
23
+ Works with Claude Code, Cursor, Cline, and [others](https://skills.sh).
24
+
25
+ 2. **Start your agent** in that project.
26
+
27
+ 3. **Type `/next-browser`** to invoke the skill.
20
28
 
21
- ## Usage
29
+ 4. The skill checks for the CLI and **installs `@vercel/next-browser`
30
+ globally** if it's missing (plus `playwright install chromium`).
31
+
32
+ 5. It asks for your dev server URL and any cookies it needs, opens the
33
+ browser, and from there it's **pair programming** — tell it what you're
34
+ debugging and it drives the tree, navigates pages, inspects components,
35
+ and reads errors for you.
36
+
37
+ That's the whole flow. Run `npx skills upgrade` later to pull updates.
38
+
39
+ The rest of this README documents the raw CLI for the rare case where you're
40
+ scripting it yourself.
41
+
42
+ ---
43
+
44
+ ## Manual install
22
45
 
23
46
  ```bash
24
- next-browser open http://localhost:3000
25
- next-browser tree
26
- next-browser ppr lock
27
- next-browser push /dashboard
28
- next-browser ppr unlock
29
- next-browser close
47
+ pnpm add -g @vercel/next-browser
30
48
  ```
31
49
 
50
+ Requires Node `>=20`.
51
+
32
52
  ## Commands
33
53
 
34
54
  ```
@@ -41,7 +61,7 @@ back go back in history
41
61
  reload reload current page
42
62
  restart-server restart the Next.js dev server (clears fs cache)
43
63
 
44
- ppr lock enter PPR instant-navigation mode
64
+ ppr lock enter PPR instant-navigation mode (requires cacheComponents)
45
65
  ppr unlock exit PPR mode and show shell analysis
46
66
 
47
67
  tree show React component tree
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vercel/next-browser",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "Headed Playwright browser with React DevTools pre-loaded",
5
5
  "license": "MIT",
6
6
  "repository": {