SHAFT

One Java 25 engine for Web, Mobile, API, CLI, and Database testing.

Fluent automation, synchronized actions, built-in assertions, rich evidence, and optional agent tools without rebuilding the framework for every surface.

Start · Connect an AI agent · Explore features · Star SHAFT

Launch shaft-mcp

Connect Codex to SHAFT browser automation, Capture, and Doctor:

curl -fsSL https://raw.githubusercontent.com/ShaftHQ/SHAFT_ENGINE/main/scripts/mcp/install-shaft-mcp.sh | sh -s -- --codex

Windows PowerShell:

irm https://raw.githubusercontent.com/ShaftHQ/SHAFT_ENGINE/main/scripts/mcp/install-shaft-mcp.ps1 | iex; Install-ShaftMcp -Client codex

Then ask:

Use SHAFT to open https://example.com, verify the page title, and summarize the generated test evidence.

Copilot / IntelliJ IDEA setup · Doctor command · Heal command

A Complete Web Test

import com.shaft.driver.SHAFT;
import org.openqa.selenium.By;
import org.testng.annotations.*;

public class SearchTest {
    private SHAFT.GUI.WebDriver driver;

    @BeforeMethod
    public void openBrowser() {
        driver = new SHAFT.GUI.WebDriver();
    }

    @Test
    public void search() {
        driver.browser().navigateToURL("https://duckduckgo.com/")
                .and().element().type(By.name("q"), "SHAFT Engine")
                .and().assertThat().title().contains("DuckDuckGo");
    }

    @AfterMethod(alwaysRun = true)
    public void closeBrowser() {
        driver.quit();
    }
}

Install SHAFT · Web guide

Go Straight to Your Goal

I want to...	Open
Test a browser	Web testing
Test Android, iOS, or Flutter	Mobile testing
Test REST or GraphQL APIs	API testing
Run terminal or file actions	CLI testing
Query and validate databases	Database testing
Diagnose a failed run	SHAFT Doctor
Recover an eligible locator	SHAFT Heal
Upgrade from SHAFT_ENGINE	Upgrade guide
Understand the modules	Architecture and modules

Evidence

SHAFT is published on Maven Central, listed in the Selenium ecosystem, and was recognized through the Google Open Source Peer Bonus program.

Contribute

Read CONTRIBUTING.md, open an issue, or join the community.

Public documentation is maintained in ShaftHQ/shafthq.github.io. Engine changes that affect users must include a linked documentation-site pull request or explain why documentation is not required.

MIT licensed. See LICENSE.