pi-chrome 0.3.1 → 0.3.2
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 +26 -4
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -9,8 +9,8 @@ Multiple Pi sessions can use Chrome at the same time. The first Pi session start
|
|
|
9
9
|
## Why try it?
|
|
10
10
|
|
|
11
11
|
- **Uses your existing Chrome profile** — works with the Chrome windows/tabs you are already using, including logged-in GitHub, admin dashboards, local apps, and internal tools.
|
|
12
|
+
- **Background by default** — agents can inspect, navigate, click, type, and snapshot without bringing Chrome to the foreground or interrupting whatever you are doing. Toggle for the whole session with `/chrome-foreground`, or pass `foreground: true` on a single tool call.
|
|
12
13
|
- **Full browser automation toolkit for Pi** — list/create/activate/close tabs, snapshot pages with usable CSS selectors, navigate, evaluate JavaScript, click, type, press keys, wait for page state, and capture screenshots.
|
|
13
|
-
- **Background by default** — agents can inspect, navigate, click, type, and snapshot without bringing Chrome to the foreground or interrupting whatever you are doing. Toggle for the whole session with `/chrome-foreground` (useful for demos, pair-driving, debugging) or pass `foreground: true` on a single tool call.
|
|
14
14
|
- **Built-in setup and agent guidance** — `/chrome-onboard` walks users through installing the companion extension, `/chrome-status` checks connectivity, screenshots save to disk, and the prompt primer tells agents to inspect with `chrome_snapshot` before acting and avoid destructive actions unless explicitly requested.
|
|
15
15
|
|
|
16
16
|
## Install
|
|
@@ -57,15 +57,37 @@ Performing Chrome bridge health check
|
|
|
57
57
|
Chrome profile bridge connected (ID: <chrome-extension-id>)
|
|
58
58
|
```
|
|
59
59
|
|
|
60
|
-
##
|
|
60
|
+
## Foreground control
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
By default, `chrome_*` tools act silently in the background — your editor or terminal keeps focus and Chrome does not pop up. This lets agents work alongside you without interrupting whatever you are doing.
|
|
63
|
+
|
|
64
|
+
When you want to watch the agent (demos, pair-driving, debugging), turn foreground on for the whole Pi session:
|
|
65
|
+
|
|
66
|
+
```text
|
|
67
|
+
/chrome-foreground # toggle
|
|
68
|
+
/chrome-foreground on # explicit
|
|
69
|
+
/chrome-foreground off # explicit
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
For a single tool call, the agent can pass `foreground: true` directly. The per-call value always wins over the session toggle.
|
|
73
|
+
|
|
74
|
+
## Quick demo prompts
|
|
75
|
+
|
|
76
|
+
After setup, try one of these in Pi:
|
|
77
|
+
|
|
78
|
+
Background inspection (no Chrome interruption):
|
|
79
|
+
|
|
80
|
+
```text
|
|
81
|
+
Inspect my active GitHub tab in the background with chrome_snapshot and summarize the PR state without focusing Chrome.
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Existing authenticated tab:
|
|
63
85
|
|
|
64
86
|
```text
|
|
65
87
|
Use chrome_tab list to find my existing GitHub tab, chrome_snapshot it, then summarize the visible PR state. Do not click anything yet.
|
|
66
88
|
```
|
|
67
89
|
|
|
68
|
-
|
|
90
|
+
Local web app repro with screenshot:
|
|
69
91
|
|
|
70
92
|
```text
|
|
71
93
|
Use chrome_tab list to find my localhost app, inspect it with chrome_snapshot, navigate through the bug repro flow, and save a screenshot when you reach the broken state.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-chrome",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "Control your existing authenticated Chrome profile from
|
|
3
|
+
"version": "0.3.2",
|
|
4
|
+
"description": "Control your existing authenticated Chrome profile from Pi with tabs, snapshots, clicks, typing, JS evaluation, waits, and screenshots \u2014 background by default.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package",
|
|
7
7
|
"pi-extension",
|