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

# Arga

> Stateful service twins and repeatable tests for apps and agents

Arga lets you test software against realistic replicas of the services it acts on. Your app or agent can read, write, retry, and fail safely without changing production data.

Arga is built around four connected parts:

* **Twin Runs** provision one or more service twins and return the URLs, credentials, and environment variables needed to use them.
* **Scenarios** save the starting state for those twins so you can reset and repeat the same conditions.
* **Test Runs and Saved Tests** exercise a URL in a browser, capture evidence, and turn successful flows into editable test blocks.
* **PR Test Runs** run saved or generated tests when a pull request changes or a configured branch receives a commit.

<Note>
  Arga provisions the service environment. Your application continues to run wherever you deploy it: locally, in staging, or at an existing preview URL. PR Test Runs do not create a new application sandbox for every pull request.
</Note>

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Run a browser test or provision your first twins.
  </Card>

  <Card title="How it works" icon="gears" href="/concepts/how-it-works">
    See how twins, scenarios, and tests fit together.
  </Card>

  <Card title="Digital twins" icon="clone" href="/concepts/digital-twins">
    Explore stateful replicas of APIs, CLIs, MCPs, and user interfaces.
  </Card>

  <Card title="Test workflows" icon="list-check" href="/features/validate-modes">
    Choose between Test Runs, Saved Tests, and PR Test Runs.
  </Card>

  <Card title="Scenarios" icon="database" href="/features/custom-scenarios">
    Save and reuse exact twin seed state.
  </Card>

  <Card title="Integrations" icon="plug" href="/integrations">
    Import scoped production data into reusable scenarios.
  </Card>
</CardGroup>

## Common workflows

<CardGroup cols={2}>
  <Card title="Test a deployed app" icon="browser" href="/features/validate-modes#test-runs">
    Give the browser runner a URL and a natural-language task, then inspect its steps and screenshots.
  </Card>

  <Card title="Test against service twins" icon="boxes-stacked" href="/features/twins-quickstart">
    Provision the services your software uses and point its provider configuration at the returned endpoints.
  </Card>

  <Card title="Repeat a known state" icon="rotate" href="/features/custom-scenarios">
    Seed twins from a saved scenario and reset them to the same baseline between attempts.
  </Card>

  <Card title="Run tests from GitHub" icon="code-pull-request" href="/features/pr-validation">
    Trigger repository tests from pull requests or pushes to a selected branch.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.