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.

FileKindSize
SKILL.mdskill md2.0 KB
---
name: app-snapshot
description: 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:
```bash
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
  "curl -s http://localhost:<port>/text-snapshot"
```

**JSON snapshot** — full DOM tree with bounds, attributes:
```bash
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
  "curl -s http://localhost:<port>/snapshot"
```

**Screenshot** — PNG image:
```bash
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:
```bash
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:
```javascript
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: 198kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall