# webapp-capture

webapp-capture captures a running web app: a narrated screen recording, route-by-route screenshots, a component library with tokens, and a UI inconsistency audit. Each mode runs as its own pass.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/browser-and-app-testing-tools/commands/webapp-capture.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/webapp-capture

## What it does

The command acts as an orchestrator. It reads the first argument (`demo`, `screenshots`, `library`, `audit`, `shadcn`, `all` or `doctor`) and walks through a single round of setup questions covering environment, theme, route list and output folder. It never touches credentials or MFA codes itself: a person logs into the app manually in a visible browser window launched by the `save-session.mjs` script, and sensitive screen regions get masked before any screenshot is reported.

Before capture starts, it loads the `webapp-capture-stinger` skill through Core's component resolver (`pest-controller-suit`); version 3 of that resolver needs `wasp-nest-core` to be present. A `doctor.mjs` check then verifies Chromium and other dependencies and must print `Ready.` before the orchestrator applies the recommended browser shard count.

The `shadcn` mode maps captured components and theme tokens onto shadcn/ui or shadcn-svelte, while `all` chains library building, the audit, the shadcn map and the demo, ending with a handoff package for Claude Design. Regular page crawls only click tabs and scroll same-origin routes; changing app state is off-limits except for an onboarding plan that the user approves in advance for a local or seeded environment.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install browser-and-app-testing-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/commands/webapp-capture.md` — Call it with /webapp-capture. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/webapp-capture.md` — Call it with /prompts:webapp-capture. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/webapp-capture.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/webapp-capture.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/browser-and-app-testing-tools/commands/webapp-capture.md

## When to use it
- record a narrated demo video of a live app
- capture route-by-route screenshots including tabs
- pull a component library with design tokens
- flag visual and code inconsistencies in the UI
- map app components onto shadcn/ui

## Example prompts
- Run /webapp-capture demo against the app at localhost:3000
- Build the component library with /webapp-capture library
- Check for UI inconsistencies using /webapp-capture audit

## Similar
- [stitched-full-page-capture](https://affpapa.org/en/nevibecode/skills/stitched-full-page-capture.md) — skill · 1800 installs
- [reviewing-interface-quality](https://affpapa.org/en/nevibecode/skills/reviewing-interface-quality.md) — skill · 451 installs
- [webapp-testing](https://affpapa.org/en/nevibecode/commands/webapp-testing.md) — command · 259 installs
- [cmux-capture](https://affpapa.org/en/nevibecode/skills/cmux-capture.md) — skill · 619 installs
- [frontend-visual-qa](https://affpapa.org/en/nevibecode/skills/frontend-visual-qa.md) — skill · 664 installs
- [gsd-ui-auditor](https://affpapa.org/en/nevibecode/agents/gsd-ui-auditor.md) — subagent · ★ 3785 repo stars

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
