SHAFT Engine · open-source Java test automation framework

Write the test. SHAFT does the rest.

One Java engine for web, mobile, API, CLI, database, and desktop. Drivers, waits, and evidence are handled. Every run ends in an Allure report.

Create new project Read the user guide

Star on GitHub

Your first run

Generate project
mvn test
Inspect report

Already on Maven? Install SHAFT · See agent-to-evidence workflow

Real run, no mockups. A 3-line test, mvn test, and the report it writes.

Three lines in. A green report out.

Write

QuickStartTest.java
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser().navigateToURL("https://shafthq.github.io/")
      .and().element().assertThat(By.cssSelector("h1")).isVisible();
driver.quit();

Run

Terminal
$ mvn test
[INFO] Running hero.QuickStartTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

Prove

Output from a real run of this test. Open the report to inspect every step, screenshot, and log.

See SHAFT in 100 seconds

Why teams pick SHAFT for new Java suites, and how an existing Selenium suite moves over without a rewrite. Captions are on; nothing downloads until you press play.

0:00 Red build: bug or flaky test?
0:20 One engine on proven tools
0:36 Waits, reports and scale built in
0:57 Upgrade an existing suite
1:16 Open source, and how to start

Prefer the technical walkthrough? Watch it in the quick start.

From intent to reviewable Java and evidence.

Capture a flow, review the Java it generates, and diagnose failures from the evidence. Engineers stay in control; leads get a release signal they can inspect.

Capture lifecycle

`capture_start` `capture_stop` `capture_generate_replay`

Capture an approved flow, review generated native Java, then retain replay evidence with the recording.

Reviewed native Java
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser().navigateToURL("https://example.com");
driver.element().click(By.id("submit"));

Evidence first

Failed Allure or trace evidence classified cause review-only remediation guidance

Run doctor_analyze_failed_allure or doctor_analyze_trace to classify evidence before reviewing a proposal.

Doctor output
classification: locator
evidence: failed Allure action and trace context
next step: review remediation guidance

Model choice remains with the MCP client. Tests remain ordinary Java. Proposals do not silently edit, approve, or merge.

Pick your starting point

Most teams start with one of these three. Upgrading an older suite? The quick start also covers the existing-project upgrade.

Create a project

Generate a Maven project and run the sample.

Create a project

Upgrade a Java project

Move an existing Maven suite onto current SHAFT and run one test.

Upgrade a project

Run in CI

Run the suite headlessly and keep the report.

Run in CI

Agents and IDE

Install skillsAdd the SHAFT skill pack to the agent you already use.
Use the IntelliJ pluginOpen the SHAFT tool window and finish setup.
Connect an MCP clientList SHAFT tools in Codex, Copilot, Claude, or another client.
Use shaft-cliRun one SHAFT command from the terminal.
Install ChaosEngineInstall the project-local agent harness and read the result.

Surfaces and infrastructure

Add a test surfaceAdd web, API, mobile, database, or CLI to a project that already runs.
Install local infrastructureInstall the Android, Appium, Grid, or browser profile you chose.

One evidence model across six test surfaces

Each surface runs on its native engine. The suite, the API style, and the report stay the same.

Native engine

Selenium WebDriver

Actions, screenshots, trace context, and Allure steps.

Read web guide

Web SHAFT snippet
SHAFT.GUI.WebDriver driver = new SHAFT.GUI.WebDriver();
driver.browser().navigateToURL("https://example.com");
driver.element().click(By.id("submit"));

Native engine

Appium

Touch actions, device context, screenshots, and native trace evidence.

Read mobile guide

Mobile SHAFT snippet
driver.touch().tap(SHAFT.GUI.Locator.accessibilityId("Views"));
driver.assertThat().element(By.id("screen")).exists().perform();

Native engine

Appium Windows driver

The same click and type facade as web, with UIA control routing and report evidence.

Read desktop guide

Desktop SHAFT snippet
SHAFT.Properties.platform.set()
        .targetPlatform("Windows")
        .executionAddress("http://127.0.0.1:4723");
new DriverFactory().getHelper(DriverFactory.DriverType.APPIUM_WINDOWS);

Native engine

REST Assured

Requests, responses, assertions, and report attachments.

Read api guide

API SHAFT snippet
SHAFT.API api = new SHAFT.API(apiFixtureUrl);
api.get("users").performRequest();

Native engine

JDBC

Connection target, query result, validation, and report evidence.

Read database guide

Database SHAFT snippet
SHAFT.DB database = new SHAFT.DB("jdbc:h2:mem:test");
ResultSet rows = database.executeSelectQuery("SELECT 1");

Native engine

Local, Docker, SSH

Commands, captured output, and validation in the same report.

Read cli guide

CLI SHAFT snippet
String output = SHAFT.CLI.terminal()
        .performTerminalCommand("echo Hello SHAFT");

Open, current, and checked

SHAFT releaseSHAFT 10.4.20261013 is the current release on Maven Central.Java baselineBuilds and runs on Java 25.MIT licenseUse, fork, and inspect it under a permissive license.CI gateEvery pull request runs the same public checks.Selenium ecosystemListed in Selenium’s official ecosystem directory.

Common questions

Is SHAFT free to use?

Yes. SHAFT is open source under the MIT license.

Do I have to rewrite my Selenium tests?

No. Move an existing Maven suite onto current SHAFT and run one test first. Upgrade a project.

Which Java version do I need?

Java 25. Installation lists the rest.

Write your first test today.

Generate a starter project, read the guide, or star the repo so other testers find it.

Create new project Read the user guide

Star on GitHub

Supported by

These companies provide tooling or open-source program support. This is not a claim of financial sponsorship, customer status, or endorsement. JetBrains and the JetBrains logo are trademarks of JetBrains s.r.o. DXC Technology imagery is reproduced courtesy of DXC Technology; unauthorized use is not permitted.