Pyxis turns the UI tests you already run into a map of screens, states and transitions. Follow a journey, compare variants, and share the whole picture in one file. Local-first and free.
Live example · Expand a domain or choose a journey. Drag to pan, pinch to zoom.Open in Pyxis ↗
Not a screenshotThe real Pyxis viewer with its bundled Notes example. Expand a domain or choose a journey, drag to pan, and pinch or ⌘ scroll to zoom. Open it full size ↗
A screenshot shows a state. A map shows the journey.
Add a PyxisRecorder to a synchronous or async XCTest. Capture the checkpoints that matter and record the actions between them. A failed transition stays in the recording.
notes.home.listHome · List
notes.editor.emptyEditor · Empty
notes.editor.filledEditor · Filled
Names that stay put
Stable state IDs survive renamed test methods, and give people and coding agents a shared way to say “the clipped title in notes.editor.empty”.
Light
Dark
Large text
Dark · Large
Every variant, side by side
Profiles record the same journey in dark mode, with larger text, or with your own launch values. Show all variants lays them out as one contact sheet.
Before
After
Diff two states
Click one state, Shift-click another and run Diff. Or arm a diff source and compare whole pages, configurations or new recordings against it.
notes.pyx
Screenshots
States and journeys
Profiles
One file to share
Captures, state details and results travel in one .pyx archive. Open it in any browser without running the app again.
Search commands
Show all states
Show all variants
Use as diff source
Diff
Everything is a ⌘K away
The command palette reaches every viewer action, and shortcuts are yours to record, change or reset.
Two parts. One recording. Record in Swift, explore on the web.
The package and viewer work independently, connected by a portable recording format. The Swift package is MIT licensed; the viewer is free, with an open-source release planned.
pyxis-swift
Your tests already know the way
Add recording to existing or dedicated UI tests. Your app keeps its navigation, fixtures, and state IDs. Pyxis captures the checkpoints and exports the result
Add recording to synchronous or async XCTest journeys
Record and optimize a variant matrix or selected configurations from YAML
Update a persistent recording store and export a complete .pyx
Drop a recording onto the canvas and explore it by screen or state. Inspect captures, follow journeys, and compare variants without running the app again
Drop a .pyx file directly into the viewer
Inspect captures at their stored resolution and compare variants
Load images on demand
Explore recordings in the free browser viewer
From a test run to the whole journey.
01
Record a journey
Choose meaningful checkpoints in your UI tests. Pyxis records their captures, variants, and transitions
02
Build one artifact
Record selected configurations and optimize images in one command. Export a complete .pyx, including earlier recordings retained in your store
03
Explore the map
Open the viewer and drop in a .pyx file. Follow a journey, inspect a state, or compare two captures
Your first .pyx in three commands. Start with a sample recording.
zsh
~ % swift run pyxis demo --output .generated/demo✓ Wrote a sample Notes recording~ % swift run pyxis validate .generated/demo✓ States, journeys and profiles are valid~ % swift run pyxis pack .generated/demo --output .generated/demo.pyx✓ Packed .generated/demo.pyx Drop it into pyxis.capturecontext.dev
Run from the package checkout
Generate a sample recording with synthetic screenshots, validate it, and pack it into a .pyx to drop into the viewer. Use a new archive name when you repeat it. Swift 6.2+ · macOS 14+
01 · Generate a recording
swift run pyxis demo --output .generated/demo
02 · Validate the bundle
swift run pyxis validate .generated/demo
03 · Package it for sharing
swift run pyxis pack .generated/demo --output .generated/demo.pyx
The viewer reads imported files on your device. No upload endpoint, account requirement, or telemetry.
A recording you can keep
Export a complete .pyx, or save a copy for offline use in this browser. Keep your store locally, in Git or LFS, or on a mounted drive.
Share it with your team
Send a .pyx file for teammates to open in the viewer. Your app code and authored tests remain the source of truth.
And the small things you would miss.
Journeys across domains
Screens with several states
Dark mode profiles
Large text profiles
pyxis merge
pyxis optimize
System UI with .screen captures
Journeys across domains
Screens with several states
Dark mode profiles
Large text profiles
pyxis merge
pyxis optimize
System UI with .screen captures
Synchronous and async XCTest
Portable .pyx archives
Library of saved recordings
Custom shortcuts
Offline copies in the browser
State IDs agents can reference
MIT-licensed Swift package
Synchronous and async XCTest
Portable .pyx archives
Library of saved recordings
Custom shortcuts
Offline copies in the browser
State IDs agents can reference
MIT-licensed Swift package
FAQ
Is Pyxis free?
Yes. The Swift package is open source under the MIT license, and the browser viewer is free to use.
Where do my recordings go?
Nowhere you did not send them. The viewer reads imported files on your device, with no upload endpoint, account or telemetry. Saved copies stay in your browser's storage.
What can it record?
iOS apps, from XCTest UI tests on iOS 17 or later. The command-line tools need macOS 14 and Swift 6.2 or later.
Do I need to rewrite my UI tests?
No. Create a PyxisRecorder in an existing test and keep its assertions and base class, or subclass PyxisTestCase for tests dedicated to recording.
Is the viewer open source?
Not yet. An open-source release of the browser viewer is planned.
See where your next screen leads. Open the viewer and drop in a .pyx.