Skip to content

fix: correct client support claims across package metadata - #19

Merged
gabelul merged 1 commit into
mainfrom
chore/positioning-and-metadata
Jul 20, 2026
Merged

fix: correct client support claims across package metadata#19
gabelul merged 1 commit into
mainfrom
chore/positioning-and-metadata

Conversation

@gabelul

@gabelul gabelul commented Jul 20, 2026

Copy link
Copy Markdown
Owner

The plugin and npm manifests described stitch-kit as a Claude Code tool. The installer has handled seven clients for months, at three different tiers depending on what each host accepts. Anyone reading the plugin browser or the npm page was told less than they were getting.

What changed

Client support, stated honestly. New "Works with" table, tiered by real capability and verified against stitch-kit status output rather than the client table in the source:

Client Stitch MCP Agent Skills
Claude Code ✅ via plugin
Codex CLI
OpenCode
Crush
Cursor
VS Code
Gemini CLI via extension

Descriptions aligned across npm, both plugin manifests, and the marketplace. Added opencode, cursor, crush, gemini-cli to npm keywords.

Real output above the fold. The README previously shipped three hand-authored SVGs — a banner, a pipeline diagram, an architecture diagram — and zero screenshots of anything stitch-kit produced. For a tool that argues about aesthetic quality, that's a bad look. Four real generated screens now sit above the install command, chosen for range: 2 desktop / 2 mobile, 2 light / 2 dark.

Dependency disclosed up front. The Google account and API key requirement moved from Prerequisites (170 lines down) to above the install command, with the actual access situation stated — no waitlist, free as of mid-2026, monthly generation limits, paid tiers signalled.

Troubleshooting entry for a Stitch API quirk that cost real time: get_screen reports a screen as 2560x2048 and then serves a 512px thumbnail unless you append =s0 to the download URL. No error, no warning.

Note on the commit type

fix: rather than docs: deliberately. Evidence from this repo's history: docs: and chore: commits appear in changelogs but never trigger a release on their own — two chore: commits sat on main for two months without cutting 1.10.1. The corrected metadata only reaches npm and the plugin browser if a release ships, and shipping wrong compatibility claims is the thing being fixed.

Merging this cuts 1.11.1.

The plugin and npm manifests described stitch-kit as a Claude Code tool.
The installer has handled seven clients for months — Claude Code, Codex CLI,
OpenCode, Crush, Cursor, VS Code, Gemini CLI — at three different tiers
depending on what each host accepts. Anyone reading the plugin browser or
the npm page was told less than they were getting.

- Align descriptions across npm, both plugin manifests, and the marketplace
- Add a "Works with" table tiered by real capability, verified against
  `stitch-kit status` output rather than the client table in the source
- Lead the README with four real generated screens above the install
  command; it previously shipped only SVG diagrams, which is a poor look
  for a tool that argues about aesthetic quality
- Move the Google Stitch account requirement above the install command
  instead of 170 lines below it, and state the access reality
- Log the screenshot resolution quirk: get_screen returns a 512px thumbnail
  while reporting 2560x2048, unless you append =s0 to the download URL
- Add opencode, cursor, crush, gemini-cli to npm keywords
- Ignore .omc/, which is local agent state
@gabelul
gabelul merged commit b965811 into main Jul 20, 2026
1 check passed
@gabelul
gabelul deleted the chore/positioning-and-metadata branch July 20, 2026 17:53
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.

1 participant