Skip to content

feat: ship pixelbrowse as an opencode plugin - #129

Draft
tauanbinato wants to merge 1 commit into
StarTrail-org:mainfrom
tauanbinato:feat/opencode-plugin
Draft

feat: ship pixelbrowse as an opencode plugin#129
tauanbinato wants to merge 1 commit into
StarTrail-org:mainfrom
tauanbinato:feat/opencode-plugin

Conversation

@tauanbinato

Copy link
Copy Markdown

Summary

Closes #117.

Adds plugin/opencode/ — an npm package (opencode-pixelbrowse) so opencode users can load pixelbrowse under "plugin" in opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-pixelbrowse"]
}

The plugin registers a screenshot custom tool (via @opencode-ai/plugin) that:

  • runs pixelshot <target> --output /tmp/pixelbrowse --tile-height 1568 (plus --wait-network-idle for URLs) — the same visual-readability defaults the Claude Code skill mandates
  • supports URLs, local HTML files, PDFs, and images, with optional output and viewportWidth args
  • returns the sorted tile image paths so the agent reads them directly with its Read tool
  • embeds the skill's key guidance in the tool description (when to use, tile ordering, Pillow crop-and-zoom for small text)
  • returns a friendly install hint (uv tool install pixelrag / pipx / pip) when pixelshot is not on PATH

Also adds an opencode note in plugin/README.md and the main README's "Give Claude eyes" section.

Notes for maintainers

  • Publishing: the package is not published yet — npm publish --access public from plugin/opencode/ (documented in its README). Happy to adjust the package name if you'd prefer a scoped one (e.g. @startrail/pixelbrowse).
  • Validation done: node --check, npm pack --dry-run, and an import smoke test (PixelbrowsePlugin loads and registers the screenshot tool). Not yet exercised end-to-end inside a live opencode session.

Test plan

  • Maintainer: npm publish --access public from plugin/opencode/
  • With pixelshot on PATH, add "plugin": ["opencode-pixelbrowse"] to opencode.json and run e.g. opencode run "screenshot https://news.ycombinator.com and summarize the top stories"

Adds plugin/opencode/, an npm package (opencode-pixelbrowse) that registers
a screenshot custom tool via @opencode-ai/plugin. The tool runs pixelshot
with the same visual-readability defaults as the Claude skill
(--tile-height 1568, --wait-network-idle for URLs) and returns the tile
paths for the agent to read.

Closes StarTrail-org#117
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

@tauanbinato is attempting to deploy a commit to the andylizf's projects Team on Vercel.

A member of the Team first needs to authorize it.

@tauanbinato
tauanbinato marked this pull request as draft July 29, 2026 04:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[feat] Ship pixelbrowse as an opencode plugin

1 participant