Skip to content

nddipiazza/robos / .agents/skills/app-snapshot

app-snapshot

Verified

Capture 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.js for 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');
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall