> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testcompanion.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Record and capture web interactions with the Test Companion browser extension

## Test Companion Browser Extension

Our Chrome extension allows you to record web interactions and automatically generate test cases and bug reports.

### Key Features

<CardGroup cols={3}>
  <Card title="Record Interactions" icon="video">
    Capture clicks, inputs, and navigations with timestamps
  </Card>

  <Card title="Auto Screenshots" icon="camera">
    Automatically capture screenshots during recording
  </Card>

  <Card title="Manual Capture" icon="image">
    Take full-page screenshots at any time
  </Card>
</CardGroup>

## Getting Started

<Steps>
  <Step title="Install Extension">
    Install Test Companion from the [Chrome Web Store](https://chrome.google.com/webstore/detail/test-companion)
  </Step>

  <Step title="Configure Recording Key">
    1. Click the extension settings icon 2. Navigate to Settings/Configurations 3.
       Enter your recording key from Test Companion dashboard 4. Enable screenshot
       capture if desired
  </Step>

  <Step title="Start Recording">
    1. Click the Test Companion extension icon
    2. Add optional recording details:
       * Name: Identify your recording
       * Tag: Group related recordings
    3. Click "Start" to begin recording
  </Step>
</Steps>

## Recording Options

### Automatic Upload

With a configured recording key, your recordings will automatically:

* Upload to your Test Companion account
* Associate with your selected project
* Be available for test case generation

### Manual Download

You can also:

* Download recordings locally
* Save for later upload
* Share with team members

### Manual Capture

During or outside of recording:

* Click the "Capture" button
* Take full-page screenshots
* Include in your recordings

## Recording Details

<CardGroup cols={2}>
  <Card title="Name Your Recording" icon="tag">
    Add descriptive names to easily identify recordings
  </Card>

  <Card title="Add Tags" icon="tags">
    Organize recordings by feature, component, or purpose
  </Card>
</CardGroup>

<Note>
  Setting names and tags helps organize recordings and makes them easier to find
  when generating test cases or bug reports.
</Note>

## Extension Settings

### Configuration Options

* Recording Key: Link to your Test Companion account
* Screenshot Capture: Enable/disable automatic screenshots
* Data Management: Clear local recording data

<Warning>
  Clearing stored data will permanently delete all local recordings and
  settings. Make sure your recordings are uploaded or downloaded before
  clearing.
</Warning>

## Best Practices

1. **Before Recording**

   * Configure your recording key
   * Plan your test scenario
   * Use meaningful names and tags

2. **During Recording**

   * Perform actions deliberately
   * Take additional screenshots when needed
   * Verify actions appear in Recent Actions

3. **After Recording**
   * Review recorded steps
   * Download locally if needed
   * Verify successful upload

<Tip>
  Use tags consistently across your team to maintain organized recordings that
  are easy to find and manage.
</Tip>
