docs(pixelbrowse): recommend uv tool/pipx install so pixelshot is on PATH (#45)
A plain `pip install pixelrag` into a project venv can leave `pixelshot` off PATH, so the skill can't find it and the agent wastes turns hunting. Recommend `uv tool install pixelrag` (or pipx) — isolated yet always on PATH — and tell the skill to install it that way if missing instead of searching venvs.
This commit is contained in:
@@ -73,10 +73,12 @@ The renderer also ships as a Claude Code plugin — the **pixelbrowse** skill. I
|
||||
raw HTML, Claude screenshots a page with `pixelshot` and _reads the image_, so it sees
|
||||
charts, diagrams, tables, and layout the way a person does.
|
||||
|
||||
Install it — no clone needed (`pixelshot` comes from `pip install pixelrag`):
|
||||
Install it — no clone needed. Install the `pixelshot` CLI so it's on your `PATH`
|
||||
(use `uv tool` or `pipx` to keep it isolated yet always available to Claude — a
|
||||
plain `pip install` into a project venv may leave `pixelshot` off `PATH`):
|
||||
|
||||
```bash
|
||||
pip install pixelrag # provides the pixelshot command
|
||||
uv tool install pixelrag # pixelshot on PATH (or: pipx install pixelrag)
|
||||
claude plugin marketplace add StarTrail-org/PixelRAG
|
||||
claude plugin install pixelbrowse@pixelrag-plugins
|
||||
```
|
||||
|
||||
@@ -13,6 +13,10 @@ allowed-tools: "Bash, Read"
|
||||
|
||||
Use `pixelshot` to capture any URL or document as tiled JPEG images, then read the images visually.
|
||||
|
||||
Requires the `pixelshot` command on `PATH`. If `pixelshot` is not found, install it
|
||||
(isolated, on `PATH`): `uv tool install pixelrag` (or `pipx install pixelrag`, or
|
||||
`pip install pixelrag`) — then retry. Don't go hunting for it in project venvs.
|
||||
|
||||
## How to use
|
||||
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user