SHAFT is a Maven-published test automation engine with one fluent API for synchronized actions, assertions, configuration, test data, reporting, evidence, and optional agent-assisted workflows.
- Web, mobile, API, CLI, database, validation, test data, and reporting APIs.
- Built-in synchronization, assertions, screenshots, logs, and Allure evidence.
- TestNG, JUnit 5, and Cucumber integration.
- Required
shaft-engineruntime plus optional modules for MCP, Capture, Doctor, Heal, AI providers, BrowserStack, local video, and visual processing. - Deterministic agent workflows through SHAFT MCP, Capture, Doctor, and Heal, with provider-backed AI features kept optional.
| Goal | Open |
|---|---|
| Evaluate SHAFT quickly | SHAFT at a glance |
| Create and run a project | Quick start |
| Install or generate a project | Installation |
| Understand artifacts and boundaries | Architecture and modules |
| Test browsers | Web testing |
| Test mobile apps | Mobile testing |
| Test REST or GraphQL APIs | API testing |
| Use agent tools | SHAFT MCP |
| Diagnose or recover failed runs | Doctor and Heal |
| Upgrade an existing project | Upgrade guide |
SHAFT is published on Maven Central, listed in the Selenium ecosystem, and was recognized through the Google Open Source Peer Bonus program.
Read CONTRIBUTING.md for the full local setup, validation, documentation, and pull request checklist.
Public product documentation is maintained in ShaftHQ/shafthq.github.io. User-facing engine changes need a linked documentation pull request or a clear reason why documentation is not required.
MIT licensed. See LICENSE.