> For the complete documentation index, see [llms.txt](https://docs.bugbug.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bugbug.io/quick-start/setup-bugbug.md).

# Setup BugBug

Sign up for BugBug for free with your email, Google, GitHub or Microsoft account, confirm your email, start the 14-day trial and install the Test Recorder.

## Quick and hassle-free setup

* Setting up BugBug takes only a few minutes.
* You don't need programming skills to record and run tests.
* Signing up is free and doesn't require a credit card.
* A 14-day trial of the paid features starts during sign-up.
* When the trial ends, you're moved to the Free plan automatically, unless you choose a paid plan - see [pricing](https://bugbug.io/pricing/).

## Sign up

Go to [sign up](https://app.bugbug.io/sign-up/) and choose one of the options:

* your work email and a password,
* your Google account,
* your GitHub account,
* your Microsoft account.

![](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FK6ufW3FXDMmVyUAohD45%2FGroup%207.png?alt=media\&token=553ee8a9-a967-4274-a1bf-4775a05b1ee5)

If you signed up with an email and a password, go to your inbox and **confirm your BugBug account** with the link from the email. If you sign up with Google, GitHub or Microsoft, or through an invitation link from your team, you don't need to confirm your email.

![](https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2F57E5Fnr5hTMraYmLvo6k%2Fimage%2019.png?alt=media\&token=ef25fd67-a02e-4ff4-b991-ac9fb23f517f)

The password must have at least 8 characters, can't be too similar to your email address, can't be a commonly used password and can't consist of digits only.

## Tell us about yourself

After you confirm your email, BugBug asks for your first and last name, company name and job position. Then your 14-day trial starts.

## Your 14-day trial

During the trial, you can use the paid features, such as cloud runs and schedules. The top bar shows how many days are left. See the trial limits in [Plans & limits](https://docs.bugbug.io/plans-and-data/plans-and-limits.md#trial).

When the trial ends, BugBug moves your organization to the Free plan. If you need more time to decide, write to <support@bugbug.io> and ask for a trial extension. To keep the paid features, choose a plan in **Organization settings > Subscription**.

If you were invited to an existing organization, you join your team's organization and its plan instead.

## Install Test Recorder

To record tests and run them locally in your browser, install the [BugBug Chrome Extension Test Recorder](https://chromewebstore.google.com/detail/bugbug-automation-testing/oiedehaafceacbnnmindilfblafincjb?hl=en-US\&utm_source=ext_sidebar) and enable it in Incognito mode.

Creating tests and running them in the cloud through the BugBug app, [CLI](https://docs.bugbug.io/integrations/cli.md), [Public API](https://docs.bugbug.io/integrations/public-api.md) or [BugBug MCP](https://docs.bugbug.io/ai-testing/mcp.md) doesn't depend on the extension.

<figure><img src="https://3168433179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKixgeBPbLvnD0l1eiV%2Fuploads%2FEcwnZ2QvzFXkfLehw4xv%2FScreenshot%202026-03-31%20at%2015.42.08%201.png?alt=media&amp;token=68ca00ba-5c32-4bcc-9b24-5061a98759bc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[Read the BugBug Test Recorder guide.](https://docs.bugbug.io/quick-start/install-test-recorder.md)
{% endhint %}

## Connect your AI agent (optional)

If you work with an AI coding agent, connect it to BugBug so it can create, run and fix tests in your projects. The quickest way is [BugBug Plugin](https://docs.bugbug.io/ai-testing/plugin.md), which configures [BugBug MCP](https://docs.bugbug.io/ai-testing/mcp.md) and BugBug Skills together:

```bash
npx @bugbug-io/cli plugin --agent=<claude|codex|cursor|copilot|vscode>
```

{% hint style="info" %}
BugBug MCP requires a **Pro or higher** plan. Claude Desktop and ChatGPT connect through the hosted endpoint - see [BugBug MCP](https://docs.bugbug.io/ai-testing/mcp.md) for setup.
{% endhint %}

## Next step

Set up your first test, suite, schedule and alert in [Your first automated flow](https://docs.bugbug.io/quick-start/your-first-automated-flow.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bugbug.io/quick-start/setup-bugbug.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
