Replay one user-journey step while your agent codes

Journey SDK turns real user flows into replayable Python steps. Agents can run the exact step they are changing over and over, inspect browser/email/webhook evidence, then verify the branch or full journey before finishing.

Open source Python 3.12+ Apache 2.0
One authored journey 2 executable cases compiled
Journey map
Create cart
Add shipping address
Choose shipping
Pay by card
Pay by wallet
Verify order in external system long-running

The step replay loop

A coding agent develops one meaningful step, reruns only that step after each edit, inspects evidence, then broadens to branch and full-journey verification.

1Read Journey instructions

AGENTS.md
1. Run the journey
2. Develop one step
3. Fix and rerun
4. Verify full journey
5. Report evidence

Agent starts from installed Journey guidance instead of inventing a test shape.

2Load agent guidance

$ journey agent codex
ok instructions
ok loop guide
ok key commands
ok touchpoint refs

One command gives the agent every loop primitive it needs.

3Find the failing step

$ journey verify --file journeys/checkout_journey.py

Running journey...
Step failed: receive_confirmation_email
Retry failed step: journey loop receive_confirmation_email --file journeys/checkout_journey.py

The agent uses the first executable failure as the target.

4Develop one step

$ journey loop receive_confirmation_email --file journeys/checkout_journey.py

Running step...
Waiting for email...

Run just the late step. State is durable.

5Fix and rerun until green

Step failed X
Timeout waiting for email

Agent fix...

$ journey loop receive_confirmation_email --file journeys/checkout_journey.py
Step passed

Agents can iterate this one step repeatedly.

6See evidence

Browser recording
trace.zip
video.webm 00:12

Email received
From: shop@example.com
Subject: Your order confirmation

Artifacts, logs, recordings, and payloads prove the journey worked.

7Verify full journey

$ journey verify --file journeys/checkout_journey.py --fresh

Full journey passed
Execution time: 4m 21s

Run the whole journey and its branches from a fresh path.

Loop one step. Inspect evidence. Verify wider.

Quickstart

Start with one prompt. Journey turns it into a durable verification loop.

codex + journey 21:43:01
  1. 01 you> Fix checkout email delivery with Journey SDK. Loop the failing step, then verify the journey.
  2. 02 codex> I'll load Journey guidance, inspect the journey, and target one replayable step.
  3. 03 $ journey agent codex
  4. 04 ok instructions
  5. 05 ok loop guide
  6. 06 ok key commands
  7. 07 ok touchpoint refs
  8. 08 codex> Running the journey before editing.
  9. 09 $ journey verify --file journeys/checkout_journey.py
  10. 10 First failing step: receive_confirmation_email
  11. 11 codex> Targeting receive_confirmation_email.
  12. 12 $ journey loop receive_confirmation_email --file journeys/checkout_journey.py
  13. 13 Timeout waiting for email
  14. 14 codex> Fixing the app and rerunning only this step.
  15. 15 Step passed after fix
  16. 16 codex> Fresh branch and full-journey verification.
  17. 17 $ journey verify --file journeys/checkout_journey.py --fresh
  18. 18 Full journey passed
  19. 19 Evidence: trace video email webhook
  20. 20 human> Readable journey + concrete evidence
timeline:

Touchpoints

Off-the-shelf resources for side effects agents otherwise struggle to verify: browser traces, Docker logs, hosted email, hosted webhooks, and more touchpoints over time.

Available now

Use today for end-to-end verification.

  • Hosted email inbox

    Dedicated inboxes your app can email. Agents can wait for, read, and assert messages.

    Learn more
  • Hosted webhook endpoint

    Stable, secure endpoints that capture events from your system in real time.

    Learn more

Roadmap

Coming next as Journey Cloud grows.

  • Phone numbers and SMS

    Planned
  • Payment cards

    Planned
  • Voice calls and IVR

    Planned
  • Messaging channels

    Planned