Menu
Route Rebel app verification to the cheapest reliable path, then launch, drive, or screenshot the Electron app when the selected recipe requires it.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Removes bundled MCP connector infrastructure from rebel-app and updates catalog
Removes dead bundled MCP connector code and updates build/package configuration
Implements OSS MCP contribution flow features using CHIEF_ENGINEER workflow patterns — TDD, IPC contracts, store creation, UI wiring
Fixes startup migration ordering, reconnect UI flows, and updates tests for migrated connectors
Ports a bundled MCP connector to the mcp-servers repo as an OSS npm package
Creates and modifies skill files, workflow docs, reference docs, CI workflows, and TypeScript scripts following existing rebel-system and repo patterns.
| name | run-app |
| description | Route Rebel app verification to the cheapest reliable path, then launch, drive, or screenshot the Electron app when the selected recipe requires it. |
Heads-up — launching uses your REAL
userData. The dev/packaged app reads and writes~/Library/Application Support/mindstone-rebel(your real conversations), shared with your installed app. Launching a build whoseDATA_SCHEMA_EPOCHdiffers from your installed app (a worktree, adev-branch dev server, or a beta build) can flip the store read-only and risk your real data — this is what caused the 2026-06-16 session-index-collapse (folders looked empty). Prefer an epoch-matching build, or point app data at a throwaway dir. SeeGIT_WORKTREES.md§ epoch mismatch / read-only mode.
Start with the router: docs/project/AGENT_UI_TESTING.md. It decides whether the task belongs on standalone CLI, packaged Playwright, dev-CDP, MCP, or E2E.
For dev-time HMR/CDP verification in Claude Code, use the scripted launch path:
npm run test:preflight
npx tsx scripts/ui-test/launch-rebel-test.ts --keep-alive
npx tsx scripts/ui-test/screenshot.ts --out /tmp/rebel-dev.png
Useful launch flags: --seed-onboarding-incomplete, --cdp-port <n>, --renderer-port <n>, --test-dir <path>, --timeout-ms <n>. The script owns EPIPE-safe launch, settings seeding, CDP polling, guest/onboarding canaries, failure tails, and scoped cleanup. In --keep-alive mode it prints the PID, CDP port, test dir, log path, and exact cleanup command.
Factory's launch SSOT is .factory/commands/test-ui.md; this skill is the Claude Code entry point that routes there through the same script.
For deterministic no-TTY verification, use the packaged path instead: npx tsx scripts/drive-packaged-app.ts --seed-staged-call --screenshot /tmp/x.png. Full packaged guidance lives in docs/project/TESTING_E2E.md § Driving the packaged app interactively.