replay-user-flows

Installation
SKILL.md

Record a journey once, re-verify it forever

Exploring an app to find a journey is the expensive part, and re-driving it with a model pays that cost again on every change. Reticle flows pay it once: the journey is saved with semantic anchors and replayed deterministically afterwards.

Needs Reticle wired in the project. Not there? RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init, then the install-and-verify skill.

Record

You do not have to ask. A drive is saved as a flow automatically when the session ends, written to .reticle/flows/. Commit it: any agent on the repo can then replay it.

What decides whether it is worth committing is how you drove it. A step keeps a consequence only when you declared one, so drive the golden path like this:

reticle_act_and_wait({ sessionId, ref, action: "click", until: { kind: "signal", name: "task:created" } })

That step replays as a test. A bare reticle_act saves a click with nothing to prove, and replays green through any regression.

To name a flow deliberately rather than take the automatic one, reticle_record and reticle_flow_save do it through reticle_run. Both live on the extended surface: the default nine advertise no dispatch hatch, so they need a daemon started with RETICLE_ADVERTISE_ALL_TOOLS=1.

Installs
136
GitHub Stars
731
First Seen
Aug 15, 2026
replay-user-flows — reticlehq/reticle