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:
Zhifei Li
2026-06-22 22:20:41 +08:00
committed by GitHub
parent 22b46d648d
commit 6da67820bf
2 changed files with 8 additions and 2 deletions
+4 -2
View File
@@ -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
```
+4
View File
@@ -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