# bitti

> bitti runs plain-text web tests (.bt files, and Gherkin .feature files) on real Chrome through navigera, in-process: one native binary, no Node, no driver process, no model at run time; API tests run with no browser at all.

Each page below is markdown. The whole site in one file: https://andrey-usa.github.io/bitti/llms-full.txt

## Start

- [Install](https://andrey-usa.github.io/bitti/start/install.md): Every way to install bitti, and how to check it worked.
- [Quick start](https://andrey-usa.github.io/bitti/start/quick-start.md): One .bt file, one scenario, one run.
- [Worked examples](https://andrey-usa.github.io/bitti/start/tutorial.md): The example suites in the repository, as they are: a shop, a sign-in, data rows and shared flows, and a Kubernetes Job.

## Guides

- [Test an API without a browser](https://andrey-usa.github.io/bitti/guides/api-tests.md): Scenarios of http and exec steps that start no browser, and what each request costs.
- [Run Gherkin feature files](https://andrey-usa.github.io/bitti/guides/gherkin.md): Run .feature files as they are, beside .bt files, with their steps defined in .bt.
- [Run bitti in GitHub Actions or a container](https://andrey-usa.github.io/bitti/guides/ci.md): The GitHub Action, the container image, and a Kubernetes Job.

## Concepts

- [Flows, sign-ins and hooks](https://andrey-usa.github.io/bitti/concepts/flows.md): Steps shared between scenarios: flows, optional steps and conditions, signing in once per run, the hooks around scenarios, and handing a step to a person.

## Reference

- [The .bt format](https://andrey-usa.github.io/bitti/reference/format.md): Every top-level line, step and variable a .bt file can hold.
- [Checks: expect](https://andrey-usa.github.io/bitti/reference/checks.md): The expect table: every check a step can make, and how each comparison reads.
- [Checks: soft, ax and screenshots](https://andrey-usa.github.io/bitti/reference/checks-soft.md): `--soft` failures that fail a scenario at its end, matching the accessibility tree, and screenshot baselines and diffs.
- [Running](https://andrey-usa.github.io/bitti/reference/running.md): bitti run and its flags: which scenarios run, and in which browsers and apps.
- [Reports and evidence](https://andrey-usa.github.io/bitti/reference/reports.md): What a run prints and saves: console, jsonl, JUnit, Allure, the HTML report, video, traces, watch and shards.
- [Failures and fixes](https://andrey-usa.github.io/bitti/reference/failures.md): What a failure prints, fixing locators with bitti fix, and the tools that write scenarios: navigera, from-session, record, mcp.
- [Config: bitti.toml](https://andrey-usa.github.io/bitti/reference/config.md): What a run takes by default from bitti.toml, the app it starts first, and named environments.
- [bitti --help](https://andrey-usa.github.io/bitti/reference/help.md): The commands and each one's options, exactly as this build prints them.

## Agents

- [For AI agents](https://andrey-usa.github.io/bitti/agents/overview.md): What an agent gets: the skill, the MCP server with the browser and the test tools, and these docs as markdown.
- [Skill](https://andrey-usa.github.io/bitti/agents/skill.md): The guide `bitti skill` gives an agent, as this version prints it.

## Benchmarks

- [Results](https://andrey-usa.github.io/bitti/benchmarks/results.md): bitti against Playwright Test on Node and on Bun, on Playwright's own TodoMVC suite, from one CI run: time, CPU, and runner and browser memory.
- [Where bitti is not ahead](https://andrey-usa.github.io/bitti/benchmarks/losses.md): Each measure on which Playwright beat bitti in the same run.
- [The 40-scenario suite](https://andrey-usa.github.io/bitti/benchmarks/suite40.md): bitti's 40-scenario suite and its Playwright Test twin, on a shop and a gauntlet of awkward pages, which CI runs on three operating systems.

## Project

- [Changelog](https://andrey-usa.github.io/bitti/project/changelog.md): What changed in each release, and what is on the way.
- [Contributing](https://andrey-usa.github.io/bitti/project/contributing.md): How to build bitti against navigera, run its tests, and keep its performance gate green.
- [Security](https://andrey-usa.github.io/bitti/project/security.md): What bitti protects and how, and how to report a problem.