whatisgithub

What is shortest?

antiwork/shortest — explained in plain English

Analysis updated 2026-06-26

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

In one sentence

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

TypeScriptPlaywrightNode.js

How does it compare?

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 get it running?

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.

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.