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

# Using twins

Describe a world, connect your agent to it, run it, and read back what it did.

Every run is the same loop: describe a world, create it, let your agent act on it, then read what it did.

| Page                                                                     | What it covers                                                           |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| [Describe a world](/twins/using-twins/describe-a-world.md)               | The seed file: the events and emails a world starts with.                |
| [Connect your agent](/twins/using-twins/connect-your-agent.md)           | Point Claude Code, Cursor, Codex or your own agent at a world.           |
| [Run your agent](/twins/using-twins/run-your-agent.md)                   | Run an agent in a world, move its clock, and make things happen mid-run. |
| [See what your agent did](/twins/using-twins/see-what-your-agent-did.md) | Every call your agent made, and the state it left.                       |
| [Web console](/twins/using-twins/web-console.md)                         | Do the same from the browser.                                            |
| [Several twins as one unit](/twins/using-twins/several-twins.md)         | Calendar and Gmail together, as one environment.                         |

## Next

* [Describe a world](/twins/using-twins/describe-a-world.md): write the seed file.
* [Connect your agent](/twins/using-twins/connect-your-agent.md): point your agent at the world.
* [Run your agent](/twins/using-twins/run-your-agent.md): start it inside the world.

***

*Last updated: 27 October 2026*