Describe what to test. Let AI help to test the user flow.
Describe the goal and let AI operate the real app. FSQ records evidence and turns the exploration into a test you can review and replay.
An open-source project from FSQ Lab.
Install · Try one test · 中文 · Guide · Contribute
See FSQ in action
https://github.com/user-attachments/assets/aa9d0a12-2f93-4894-8349-52a013424939
Watch the full demo on YouTube.
How it works
- Describe: You define the platform and target, goal, success criteria, and allowed and forbidden actions.
- Observe as AI tests the real UI flow and FSQ captures screenshots, interface state, events, and a reviewable test.
- Control what happens next: inspect the evidence and unchanged generated test, then separately approve any deterministic replay.
You get an evidence-backed result and a portable, reusable test you can review, keep, and replay without surrendering control.
Install FSQ
Copy this prompt into your Coding Agent:
The official FSQ project is https://github.com/FSQ-lab/FSQ. Follow that project's official installation instructions to install the FSQ CLI. Before changing my environment, explain the change and obtain my permission. Verify that the
fsqcommand works, report the result, and then stop. Do not initialize a Workspace, configure a Provider, or run a test.
python -m pip install --upgrade fsq-agent
Try one test
From the project directory, run fsq init --agent skill. Reload or start a new Coding Agent session before continuing.
Copy this prompt into your Coding Agent:
Guide me through one FSQ test. Confirm the platform and target, goal and success criteria, and allowed and forbidden actions. Keep credentials out of chat. Execute only what I approve, summarize the result first, and show the returned test unchanged. Replay only after my separate explicit confirmation.
Use the FSQ UI directly
fsq ui
In Test Runner, choose the platform and target, describe the result to verify, and start testing.
Platforms
FSQ supports Web, Android, Windows, and macOS targets; see platform prerequisites, and help broaden support through contributions.
Documentation
- Getting started
- 中文快速开始
- CLI reference
- FSQ Case format
- Advanced Codex compatibility
- Platform prerequisites
- Support and stability
Built by FSQ Lab and the community
Built by FSQ Lab with thanks to all contributors. Want to help? Read CONTRIBUTING.md and join us.
License
MIT — Copyright (c) Microsoft Corporation.
1 maintainer
Metadata
1 maintainer
Release files for fsq-agent 0.1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| fsq_agent-0.1.8.tar.gz | 11.5 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fsq_agent-0.1.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.5 MB
Release files / fsq_agent-0.1.8.tar.gz
| Download URL | fsq_agent-0.1.8.tar.gz |
|---|---|
| Size | 11.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75c278ee23978c951e43ed6c5555b159f8dbd1a0215ed916c9cc48a8ca74dda5
|
|
BLAKE2b-256 checksum How to use checksums |
77014a39827baeea0f6ac6b2dfdb511bbe0ab666784223ee82412ad1a50c77bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / fsq_agent-0.1.8-py3-none-any.whl
| Download URL | fsq_agent-0.1.8-py3-none-any.whl |
|---|---|
| Size | 951.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1170d7ade91627202128557396275da501f451f8893d440cd466c2d1c864e278
|
|
BLAKE2b-256 checksum How to use checksums |
531aa363f27de4c4fbc86f4006c5da05a52ed47fb898bfe6bc5a33aa6e0ddeca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for fsq-agent 0.1.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
