@lucidlayer/reflex
v1.2.3
Published
Reflex CLI, Simulate real users and catch broken UX before launch.
Downloads
10
Maintainers
Readme
Reflex CLI by Lucid Layer
Simulate real users. Catch broken UX before launch.
What is Reflex?
Reflex is a CLI tool that spins up a headless browser, simulates real user flows, and uses AI to instantly find UX issues before you ship.
- Goal-driven: Simulate specific user goals.
- Persona-aware: Emulate different user types.
- Instant feedback: Get actionable reports in seconds.
- CLI-first: Fits right into your dev workflow.
- No more guesswork: Ship with confidence.
Installation
Global:
npm install -g @lucidlayer/reflexOr with npx (zero install):
npx @lucidlayer/reflex http://localhost:3000IMPORTANT: Set your OpenRouter API key
Reflex CLI requires an OpenRouter API key to generate UX feedback.
Get your API key:
Sign up at https://openrouter.ai and copy your API key.Create a
.envfile (or.env.local,.env.development,.env.production) in your project or home directory with:
REFLEX_OPENROUTER_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx- Or pass it as a CLI flag:
uxcheck http://localhost:3000 --apiKey sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxIf you don’t set your key, you will get a 401 Unauthorized error.
Usage
Basic scan:
uxcheck http://localhost:3000With custom goal and persona:
uxcheck http://localhost:3000 --goal "Try to sign up" --persona "new user"Manual mode (copy-paste prompt):
uxcheck http://localhost:3000 --manualSave JSON report:
uxcheck http://localhost:3000 --jsonFeatures
- Mobile viewport emulation
- Persona simulation
- Goal-driven flows
- Markdown + JSON reports
- CLI spinners and progress
- Extensible roadmap: IDE integrations, ACE autopilot, dashboard
Roadmap
- [x] CLI MVP
- [ ] Persona presets
- [ ] Multi-device support
- [ ] IDE integrations
- [ ] ACE-powered real-time testing
- [ ] Dashboard UI
Contributing
- Clone the repo
- Run
npm install - Build with
npm run build - PRs welcome!
Security
Please report vulnerabilities privately to:
[email protected]
License
MIT © 2025 Lucid Layer
Links
- Website: https://reflexlayer.com
- Twitter: @reflexlayer
- Company: @lucidlayerhq
- GitHub Org: https://github.com/lucidlayer
