getobsrv 0.3.0 → 0.3.1

package/README.md

@@ -52,18 +52,18 @@ a 1366×768 laptop / budget Android?" without the GUI. Build first
 
 ```bash
 # One PNG at a preset's true raster density (+ metadata JSON on stdout):
-node bin/obsrv.js snap http://localhost:5173 --preset laptop-768 --out shot.png
+npx -y getobsrv snap http://localhost:5173 --preset laptop-768 --out shot.png
 
 # A matrix of screens, cheap-panel simulation, full-page capture:
-node bin/obsrv.js snap http://localhost:5173 --matrix laptop-768,android-65,1080p-24 --out shots/
-node bin/obsrv.js snap http://localhost:5173 --preset laptop-768 --profile budget-tn --out tn.png
-node bin/obsrv.js snap http://localhost:5173 --preset laptop-768 --full-page --out full.png
+npx -y getobsrv snap http://localhost:5173 --matrix laptop-768,android-65,1080p-24 --out shots/
+npx -y getobsrv snap http://localhost:5173 --preset laptop-768 --profile budget-tn --out tn.png
+npx -y getobsrv snap http://localhost:5173 --preset laptop-768 --full-page --out full.png
 
 # Machine-readable 1x-vs-2x comparison (ink coverage, row ratios, band deltas):
-node bin/obsrv.js diff http://localhost:5173 --preset laptop-768 --out-dir diffout
+npx -y getobsrv diff http://localhost:5173 --preset laptop-768 --out-dir diffout
 ```
 
-`node bin/obsrv.js --help` lists every preset, profile and flag. Diff findings
+`npx -y getobsrv --help` (or `node bin/obsrv.js --help` in a checkout) lists every preset, profile and flag. Diff findings
 are informational (exit 0); CI thresholds are the caller's job. A ready-made
 Claude Code skill that wraps the loop (snap matrix → read the PNGs → diff →
 fix → re-snap) lives at [skills/obsrv-screens/SKILL.md](skills/obsrv-screens/SKILL.md).
@@ -77,7 +77,7 @@ raster density — the PNG comes back as an inline image up to 1.5 MiB),
 (every preset and panel profile, no render). Build first, then register:
 
 ```bash
-claude mcp add --scope user obsrv -- node /Users/opeyemiajagbe/Documents/Projects/Obsrv/bin/obsrv-mcp.js
+claude mcp add --scope user obsrv -- npx -y getobsrv mcp
 ```
 
 ## Develop

package/bin/obsrv.js

@@ -12,6 +12,14 @@ const { existsSync, mkdtempSync, rmSync } = require('node:fs')
 const { tmpdir } = require('node:os')
 const { join } = require('node:path')
 
+// `obsrv mcp` serves the MCP server (plain node, no Electron) so one npx
+// invocation covers both: `npx -y getobsrv mcp`.
+if (process.argv[2] === 'mcp') {
+  process.argv.splice(2, 1)
+  require('./obsrv-mcp.js')
+  return
+}
+
 const cliEntry = join(__dirname, '..', 'out', 'main', 'cli.js')
 if (!existsSync(cliEntry)) {
   console.error('obsrv: out/main/cli.js is missing — run `npm run build` in the Obsrv repo first')

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "getobsrv",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "See your site the way 1x screens see it",
   "main": "./out/main/index.js",
   "bin": {
     "obsrv": "./bin/obsrv.js",
+    "getobsrv": "./bin/obsrv.js",
     "obsrv-mcp": "./bin/obsrv-mcp.js"
   },
   "author": "Opeyemi Ajagbe <auto-report@hydrogenpay.com>",

package/skills/obsrv-screens/SKILL.md

@@ -15,30 +15,33 @@ where thin fonts, 0.5px hairlines, and low-contrast grey text actually break.
 
 ## Commands
 
-Prerequisite: `npm run build` must have been run in the Obsrv repo (the CLI
-runs the built `out/`). If a snap fails with "out/main/cli.js is missing", run
-`npm run build` in `/Users/opeyemiajagbe/Documents/Projects/Obsrv` first.
+Prerequisite: none when using `npx -y getobsrv` (npm downloads everything,
+including Electron, on first run). In a local Obsrv checkout, run
+`npm install && npm run build` there first.
 
 ```bash
-OBSRV=/Users/opeyemiajagbe/Documents/Projects/Obsrv/bin/obsrv.js
+# Installed anywhere via npm (first run downloads Electron):
+OBSRV="npx -y getobsrv"
+# Or, in a local Obsrv checkout (faster, no download):
+# OBSRV="node /path/to/Obsrv/bin/obsrv.js"
 
 # One screen, one PNG (+ JSON metadata on stdout, humans on stderr):
-node $OBSRV snap http://localhost:5173 --preset laptop-768 --out shots/laptop.png
+$OBSRV snap http://localhost:5173 --preset laptop-768 --out shots/laptop.png
 
 # The recommended matrix — small laptop, budget phone, 1080p desktop:
-node $OBSRV snap http://localhost:5173 --matrix laptop-768,android-65,1080p-24 --out shots/
+$OBSRV snap http://localhost:5173 --matrix laptop-768,android-65,1080p-24 --out shots/
 
 # Worst realistic panel (cheap TN) on the small laptop:
-node $OBSRV snap http://localhost:5173 --preset laptop-768 --profile budget-tn --out shots/laptop-tn.png
+$OBSRV snap http://localhost:5173 --preset laptop-768 --profile budget-tn --out shots/laptop-tn.png
 
 # Whole page, not just the first viewport (device px cap 4096, warns if clamped):
-node $OBSRV snap http://localhost:5173 --preset laptop-768 --full-page --out shots/full.png
+$OBSRV snap http://localhost:5173 --preset laptop-768 --full-page --out shots/full.png
 
 # Numbers instead of eyeballs: 1x target vs a 2x-reference downsample, JSON to stdout:
-node $OBSRV diff http://localhost:5173 --preset laptop-768 --out-dir shots/diff
+$OBSRV diff http://localhost:5173 --preset laptop-768 --out-dir shots/diff
 ```
 
-`node $OBSRV --help` lists every preset (`1080p-24`, `laptop-768`,
+`$OBSRV --help` lists every preset (`1080p-24`, `laptop-768`,
 `android-65`, `iphone-61`, …), profile (`reference`, `office-ips`,
 `budget-tn`, `old-laptop`), and flag (`--width/--height/--dsf`, `--wait`,
 `--timeout`).