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
.claude/commands/fraimz.mdWhat 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.mdCall it with /fraimz. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/fraimz.mdCall it with /prompts:fraimz. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/fraimz.prompt.mdManually: put the files in place
.gemini/commands/fraimz.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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.