nddipiazza/robos / .agents/skills/app-snapshot
app-snapshot
VerifiedCapture DOM snapshots (text, JSON, or screenshot) from running RobOS Electron apps for debugging without VNC.
Capture RobOS App DOM Snapshot
Capture a DOM snapshot from a running RobOS Electron app for debugging without VNC.
Input
$ARGUMENTS — <app-id> optionally followed by --json or --screenshot (default: text snapshot)
How it works
Each RobOS Electron app runs a debug HTTP server on a unique port (19100+). The snapshot captures the current DOM state — like Playwright's page.accessibility.snapshot() but for Electron.
Port Registry
- app-launcher: 19100
- dev-central: 19101
- git-projects: 19102
- (see
packages/robos-lib/snapshot-cli.jsfor full list)
Capture Methods
Text snapshot (default) — human-readable DOM tree:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
"curl -s http://localhost:<port>/text-snapshot"
JSON snapshot — full DOM tree with bounds, attributes:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
"curl -s http://localhost:<port>/snapshot"
Screenshot — PNG image:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
"curl -s http://localhost:<port>/screenshot" > /tmp/screenshot.png
Eval JS — execute arbitrary JS in the renderer:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
"curl -s -X POST -d 'document.title' http://localhost:<port>/eval"
When to use
- Debugging UI issues without VNC access
- Verifying app state after actions (click, search, navigate)
- Automated testing of RobOS apps
- Checking if elements are visible, what text they contain, their layout
Adding debug support to a new app
In the app's main.js, after creating the BrowserWindow:
const { registerSnapshotIPC, startDebugServer } = require('/usr/local/share/robos/robos-lib/dom-snapshot');
registerSnapshotIPC(mainWindow);
startDebugServer(mainWindow, PORT, 'app-id');
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |