gitwtfhub

wtf is shortest?

antiwork/shortest — explained in plain English

Analysis updated 2026-06-26

5,594TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

Shortest lets developers write automated end-to-end browser tests as plain English sentences, then uses Claude AI to drive the browser and carry them out, replacing verbose click-and-type scripts with a single natural-language description of what should happen.

Mindmap

mindmap
  root((Shortest))
    How it works
      Plain English test file
      AI reads live browser
      Claude executes actions
      Pass or fail result
    Built on
      Playwright
      TypeScript
      Anthropic API
    Features
      Chained tests
      API testing
      GitHub 2FA login
      Email verification
      CI headless mode
    Setup
      Anthropic API key
      Config file
      .test.ts files

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Replace verbose Playwright scripts with one-line English descriptions of what a web app should do.

REASON 2

Add automated login tests with GitHub two-factor authentication and email verification without writing browser automation code.

REASON 3

Run AI-driven end-to-end tests in a CI/CD pipeline where the AI figures out how to interact with the UI.

REASON 4

Write database state verification callbacks alongside AI-driven browser tests to confirm back-end side effects.

What's in the stack?

TypeScriptPlaywrightNode.js

How it stacks up

antiwork/shortesthuolalatech/page-spy-webarco-design/arco-design
Stars5,5945,5955,600
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an Anthropic API key for every test run, costs accumulate with the number and length of tests.

Wtf does this do

Shortest is a testing framework that lets developers write automated checks for web apps using plain English instead of code. Normally, end-to-end tests (tests that drive a real browser through a sequence of actions) require writing detailed scripts that click buttons, fill forms, and verify results step by step. Shortest replaces most of that scripting with a sentence describing what should happen, then uses an AI model to figure out how to carry it out. For example, instead of writing twenty lines of code to test a login flow, a developer writes one line: "Login to the app using email and password." The framework sends that instruction along with the live state of the browser to an AI model (Claude from Anthropic), which reads the page and decides what to click and type. The test passes if the AI completes the described goal without errors. The framework is built on Playwright, an existing browser automation library used widely in the industry. Shortest adds the AI layer on top. Tests are written in TypeScript files ending in .test.ts, and they can be chained together so one test picks up where another left off. Developers can also add callback functions that run after the AI finishes, so they can verify database state or other side effects that the AI cannot check by itself. Shortest supports API testing as well as browser testing, GitHub login with two-factor authentication, and integration with Mailosaur for email verification steps. It runs in CI/CD pipelines with a headless mode so tests can run on a server without a visible browser window. Setup requires an Anthropic API key, which is used to call the AI model for each test run. The README walks through installation, a configuration file, and example test files. The project is maintained by Antiwork.

Yoink these prompts

Prompt 1
I want to write a Shortest test for a login page. Show me how to install it, set up the Anthropic API key, and write my first test file.
Prompt 2
How does Shortest decide what to click and type when given a plain English instruction? Walk me through the flow from the test sentence to the browser action.
Prompt 3
I have a signup flow that includes email verification. Show me how to use Shortest with Mailosaur to handle the confirmation email step in the test.
Prompt 4
How do I add a callback to a Shortest test to verify that a new user record was created in my database after the sign-up flow completes?
Prompt 5
Set up a GitHub Actions workflow that runs my Shortest tests on every pull request using headless mode.

Frequently asked questions

wtf is shortest?

Shortest lets developers write automated end-to-end browser tests as plain English sentences, then uses Claude AI to drive the browser and carry them out, replacing verbose click-and-type scripts with a single natural-language description of what should happen.

What language is shortest written in?

Mainly TypeScript. The stack also includes TypeScript, Playwright, Node.js.

How hard is shortest to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is shortest for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.