---
title: "AgentTwin agent testing — test workflows before production"
description: "Find candidate code paths in your repository. Prepare a reviewed Node.js workflow with synthetic data and supported service operations. Run it with a supported fault, then check assertions against the"
canonical: "https://agenttwin.si/"
---

# AgentTwin agent testing — test workflows before production

Find candidate code paths in your repository. Prepare a reviewed Node.js workflow with synthetic data and supported service operations. Run it with a supported fault, then check assertions against the recorded state. Discovery alone does not make a workflow runnable. Local execution can access the host filesystem and network. E2B cloud execution is optional. The browser demo uses scripted outcomes.

## When to use AgentTwin agent testing

Check final-state assertions or retry safety after a write times out. Replay a captured result or save a reviewed scenario as a regression test. Review operation contracts first. The test world covers declared behavior, not every production condition.

## Run the shipped example

```sh
npx agenttwin example --out ./agenttwin-example
cd agenttwin-example
npx agenttwin run --seed 00000000000000000000000000000001 --fault none
npx agenttwin run --seed 00000000000000000000000000000001 --fault timeout-after-write
```

The clean run expects one ticket and one notification. The faulted run exposes duplicate tickets and should fail. See the [full quickstart](https://agenttwin.si/docs/quickstart.md) for verification, reset and replay. Review files before execution.

## Integration entry points

- [Public documentation MCP](https://agenttwin.si/mcp/docs): search and read guides over Streamable HTTP; no account access or execution.
- [Official public agent tools](https://github.com/Sashank-Singh/agenttwin-agent-tools): skills, AGENTS.md, Cursor rules and portable plugin configuration.
- [Local synthetic sandbox](https://agenttwin.si/sandbox.md): no account or provider credentials.
- [API versioning and deprecation](https://agenttwin.si/api-policy.md).
- [Agent skills](https://agenttwin.si/.well-known/agent-skills/index.json): prepare real workflows and investigate evidence.

- [Developer guide](https://agenttwin.si/developers.md): npm CLI, local MCP stdio and the documented REST subset.
- [Authentication](https://agenttwin.si/auth.md): account login and terminal pairing; authenticated customer resources.
- [OpenAPI](https://agenttwin.si/openapi.json): scoped OAuth, project metadata, test drafts and reviewed cloud test jobs.
- [API catalog](https://agenttwin.si/.well-known/api-catalog): API descriptions and health endpoint.
- [Operation contracts](https://agenttwin.si/docs/provider-operations.md): supported subsets and limitations.
- [Access and costs](https://agenttwin.si/pricing.md): no published subscription plans; configured E2B usage may be billed.
- [CLI reference](https://agenttwin.si/docs/cli.md) and [npm package](https://www.npmjs.com/package/agenttwin). Implementation source is currently private.
- [About](https://agenttwin.si/about.md), [Contact](https://agenttwin.si/contact.md), [Privacy](https://agenttwin.si/privacy.md).