Skip to main content
command CX Codex

fraimz — Claude Code command: what it does, how to install

Runs end-to-end evaluation flows for an Electron app and generates step-by-step visual proof in fraimz.html with screenshots.

LicenseRef-Proprietary ★ 7,523 updated 2026-10-29

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/fraimz.md
Open on GitHub

What fraimz does

The command drives user flows through the Chrome DevTools Protocol (CDP) to confirm UI behavior. Each step records an action, an assertion checking for side effects, and an actual screenshot. When invoked without arguments, it defaults to the repository's core-flow to test sending a message and restoring state upon restart.

Flow execution requires an active Electron target, launched either via pnpm dev locally or through bash .devcontainer/test-on-daytona.sh in Daytona. Flows reside in evals/flows/<id>.flow.mjs or can be generated with pnpm fraimz scaffold <id>. Once finished, the runner outputs fraimz.html, report.md, and report.json into evals/results/<run-id>/.

If the CDP endpoint is unreachable or the application fails to start, the runner exits immediately with diagnostic steps. Generated test proof can also be posted directly onto a pull request using the --pr option.

What it helps with

  • Generate visual step-by-step proof of UI changes with screenshots
  • Drive end-to-end Electron app testing over CDP
  • Post interactive evaluation results directly to a pull request
  • Validate session retention across application restarts

Example prompts for the agent

  • Run /fraimz on core-flow
  • Generate fraimz proof for user-login flow
  • Execute /fraimz flow-settings and attach report to PR

How to install fraimz

Manually: put the files in place

.claude/commands/fraimz.md

Call it with /fraimz. For all projects use ~/.claude/commands/

Questions about fraimz

How to install fraimz in Claude Code?

Place the command markdown file at .claude/commands/fraimz.md in your project.

What does fraimz generate?

It produces a standalone fraimz.html file alongside JSON and Markdown reports in evals/results/<run-id>/, documenting each user step with a screenshot.

How does fraimz connect to the app under test?

It connects via CDP to an Electron instance started locally with pnpm dev or through bash .devcontainer/test-on-daytona.sh.

Similar slash commands

All slash commands for Testing and QA →

From the same set42

The whole set →
daytona-chrome-cdp daytona-chrome-cdp starts a separate Chromium inside a Daytona sandbox and exposes it over CDP, so you can finish web sign-in, OAuth or admin flows in a real browser. CX Codex +1 ★ 7,523repo stars ipollowork-presentations ipollowork-presentations guides agents in building and refining slide decks inside an iPolloWork Design session while keeping layout contracts and tokens intact. CX Codex +1 ★ 7,523repo stars daytona-cloud-server daytona-cloud-server starts iPolloWork’s server side in Daytona, including Den, MySQL, and the worker proxy. Use it to test cloud flows separately from the Electron client. CX Codex +1 ★ 7,523repo stars daytona-electron-den daytona-electron-den runs a real Electron build against a Den server in two Daytona sandboxes, then collects proof: health checks, bootstrap state, screenshots and a recording. CX Codex +1 ★ 7,523repo stars run-evals The run-evals skill launches iPolloWork and runs coded E2E flows through CDP. Use it to check a feature and produce run artifacts for a PR. CX Codex +1 ★ 7,523repo stars voiceover The voiceover skill writes the demo narration before any code exists, then carries the feature through to a pull request with frame-by-frame proof attached. Useful when the team should agree on what a viewer sees first. CX Codex +1 ★ 7,523repo stars image-generation image-generation generates image assets through the iPolloWork service for slide decks and web pages. Operates directly in chat without opening Image Studio. CX Codex +1 ★ 7,523repo stars ipollowork-template-generation The ipollowork-template-generation skill builds and revises reusable iPolloWork templates for design, presentations, editable PPT, and HyperFrames Video. Use it to validate and save template packages. CX Codex +1 ★ 7,523repo stars

Project sponsors

Companies that keep this analytics open