Skip to main content

Quickstart

This walkthrough uses the testvibe CLI. Every step has a raw-HTTP equivalent — see the API reference — and the same operations are available to AI tools through the MCP server.

  1. Create an API key​

    In the TestVibe app, open Settings → CLI & API keys and create a key. The full key (tvb_…) is shown once — copy it now.

    warning

    Treat API keys like passwords. The key acts as you, inside your workspace.

  2. Install the CLI and log in​

    With npm:

    npm install -g testvibe

    Or without npm — download it straight from your TestVibe server (needs Node 20+):

    curl -fsSL https://testvibe.app/api/v1/install.sh | sh      # macOS / Linux
    iwr -useb https://testvibe.app/api/v1/install.ps1 | iex     # Windows PowerShell

    Then log in:

    testvibe login --server https://testvibe.app --key tvb_XXXXXXXX…

    login verifies the key against the server before saving it to ~/.testvibe/config.json. See the CLI reference for all install options.

  3. Pick a project​

    testvibe projects
    testvibe use "Acme Shop"

    use sets the default project for every command that follows. You can always override it per call.

  4. Create a feature​

    A feature is desired behavior described in Gherkin:

    login.feature
    Feature: Login Functionality
      Scenario: Valid user signs in
        Given I am on the login page
        When I sign in with valid credentials
        Then I see the inventory page
    testvibe features create "Login Functionality" --file login.feature

  5. Generate its tests​

    testvibe generate "Login Functionality" --watch

    AI generation runs in a cloud sandbox against your project's URL and takes a few minutes; --watch streams per-section progress until the generation finishes. It exits 0 only when the generation reported a successful terminal outcome — 1 if the generation failed, 2 if it stopped to ask you a question, 3 if it was still going when the wait ceiling elapsed (the CLI wait contract).

    info

    Generation consumes account credits — see Long-running operations for how dispatch + polling works.

  6. Run the tests​

    testvibe run "Login Functionality" --wait

    The run executes in an isolated sandbox and --wait prints per-test results when it finishes:

    Run #214 passed — 3/3 tests passed (31s)
      ✓ Valid user signs in (4.2s)
      ✓ Invalid password is rejected (3.8s)
      ✓ Locked-out user sees an error (3.1s)

  7. Grab the artifacts​

    testvibe runs artifacts 214

    Returns short-lived download links for the run's Playwright traces, screenshots, and videos.

Where next?​

Connect your AI tools

Let Claude or Codex do all of the above for you, via MCP.

API reference

Every operation across REST, CLI, and MCP.

Run TestVibe in CI

Gate your deploys on a green TestVibe run.

Cloud API, CLI, and MCP access requires Team or higher. See authentication and access limits.

If generation pauses, answer the question with testvibe generate answer <feature> --option "<exact option>" --watch. To inspect existing work, use the generation status REST endpoint or get_generation_status / wait_for_generation in MCP. testvibe generate <feature> --watch starts a new generation; it is not a reconnect command.