midscene

Midscene is a vision-based GUI agent and testing framework for end-to-end tests of web, mobile, and desktop apps. Describe interface actions and expected results in natural language, then use it to interact with screens and verify what users see.

Share on XLicense: MIT

Overview

Midscene is a vision-based GUI agent and testing framework for end-to-end tests of web, mobile, and desktop apps. Developers describe interface actions and expected results in natural language, and the agent uses screenshots to locate controls, interact with them, and check visible outcomes. Tests can be organized as YAML cases with Midscene Test or run through Agent APIs in existing Playwright tests. Generated HTML reports show screenshots, actions, and assertion results.

Key features

  • Describe UI actions, waits, and assertions in natural language.
  • Locate controls from screenshots and click, type, or scroll without maintaining selectors.
  • Write YAML test cases with Midscene Test or use Agent APIs with Playwright.
  • Inspect screenshots, actions, and assertion results in generated HTML reports.

Best for

Developers who want to test user-visible behavior across web, mobile, or desktop interfaces. Choose it when tests should describe what a user sees and does rather than rely on maintained selectors.

Upstream
web-infra-dev/midscene
Fork on GitHub
Guo-astro/midscene
Upstream stars
15k
Category
Developer tools and infrastructure
Language
TypeScript
License
MIT
Forked
2026-10-13
Sync status
Updated by last syncLast synced 2026-10-14