chromeflow 0.1.36 → 0.1.37
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 +37 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# Chromeflow
|
|
2
2
|
|
|
3
|
-
Browser guidance for Claude Code. When Claude needs you to set up Stripe, grab API keys, configure a third-party service, or do anything in a browser — Chromeflow takes over. It highlights what to click, fills in fields it knows, clicks buttons automatically, and writes captured values straight to your `.env`.
|
|
3
|
+
Browser guidance for Claude Code. When Claude needs you to set up Stripe, grab API keys, configure a third-party service, or do anything in a browser — Chromeflow takes over. It highlights what to click, fills in fields it knows, clicks buttons automatically, uploads files, and writes captured values straight to your `.env`.
|
|
4
4
|
|
|
5
5
|
## How it works
|
|
6
6
|
|
|
7
7
|
Chromeflow is two things that work together:
|
|
8
8
|
|
|
9
|
-
- **MCP server** — gives Claude Code a set of browser tools (`open_page`, `click_element`, `
|
|
10
|
-
- **Chrome extension** — receives those commands and acts on the active tab (highlights, clicks, fills, captures screenshots)
|
|
9
|
+
- **MCP server** — gives Claude Code a set of browser tools (`open_page`, `click_element`, `fill_form`, `set_file_input`, `read_element`, `write_to_env`, etc.)
|
|
10
|
+
- **Chrome extension** — receives those commands and acts on the active tab (highlights, clicks, fills, uploads files, captures screenshots)
|
|
11
11
|
|
|
12
12
|
Claude drives the flow. You only touch the browser for things that genuinely need you — login, passwords, payment details, personal choices.
|
|
13
13
|
|
|
@@ -49,6 +49,40 @@ Just ask Claude normally:
|
|
|
49
49
|
|
|
50
50
|
Claude will navigate, highlight steps, click what it can, pause for anything sensitive, and write values to your `.env` automatically.
|
|
51
51
|
|
|
52
|
+
## What Claude can do
|
|
53
|
+
|
|
54
|
+
| Capability | Tools |
|
|
55
|
+
|------------|-------|
|
|
56
|
+
| Navigate pages, open new tabs | `open_page`, `list_tabs`, `switch_to_tab` |
|
|
57
|
+
| Click buttons and links | `click_element` |
|
|
58
|
+
| Fill single fields | `fill_input` |
|
|
59
|
+
| Fill multiple fields in one call | `fill_form` |
|
|
60
|
+
| Upload files (even hidden inputs) | `set_file_input` |
|
|
61
|
+
| Read page content as text | `get_page_text` |
|
|
62
|
+
| Inspect all form fields | `get_form_fields` |
|
|
63
|
+
| Scroll to a known element | `scroll_to_element` |
|
|
64
|
+
| Highlight elements for the user | `highlight_region`, `find_and_highlight` |
|
|
65
|
+
| Wait for the user to click | `wait_for_click` |
|
|
66
|
+
| Wait for async changes | `wait_for_selector` |
|
|
67
|
+
| Run arbitrary JS | `execute_script` |
|
|
68
|
+
| Capture credentials to `.env` | `read_element`, `write_to_env` |
|
|
69
|
+
| Screenshot (element location only) | `take_screenshot` |
|
|
70
|
+
| Screenshot + save + copy to clipboard | `take_and_copy_screenshot` |
|
|
71
|
+
| Save/restore form state across tabs | `save_page_state`, `restore_page_state` |
|
|
72
|
+
| Show a step-by-step guide panel | `show_guide_panel`, `mark_step_done` |
|
|
73
|
+
|
|
74
|
+
### File uploads
|
|
75
|
+
|
|
76
|
+
`set_file_input` uses Chrome DevTools Protocol to bypass the browser's file-input script restriction — the same mechanism used by Playwright and Puppeteer. It works even when the `<input type=file>` is hidden behind a custom drag-and-drop zone.
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
set_file_input("Upload", "/Users/you/Downloads/task.zip")
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Dedicated Claude window
|
|
83
|
+
|
|
84
|
+
Click the Chromeflow extension icon and use **"Use this window for Claude"** to lock Claude's browser operations to a specific Chrome window. This lets you freely use other Chrome windows without Claude interfering.
|
|
85
|
+
|
|
52
86
|
## Adding to another project
|
|
53
87
|
|
|
54
88
|
Run setup from the new project's directory — the MCP server is already registered globally, this just drops `CLAUDE.md` and tool permissions into the project:
|
package/package.json
CHANGED