InstallationCopy Anchor Link

RequirementsCopy Anchor Link

• For iOS, install Xcode and an iOS Simulator runtime.
• For Android, install the Android SDK with Platform-Tools and the emulator.

Agentsims does not support physical iPhones.

InstallCopy Anchor Link

macOSCopy Anchor Link

brew install maniktherana/tap/agentsims

macOS or Linux, without HomebrewCopy Anchor Link

curl -fsSL https://agentsims.dev/install | bash

Then open a new terminal.

WindowsCopy Anchor Link

Run this command in PowerShell:

irm https://agentsims.dev/install.ps1 | iex

You can use agentsims in the same window at once. Windows on Arm runs the x64 version through emulation.

Give the skill to your coding agentCopy Anchor Link

The Agentsims skill teaches Claude Code, Codex, Cursor, and other coding agents how to use Agentsims.

agentsims skill

The curl and PowerShell installers run this command for you when Node.js is installed. After you install with Homebrew, run it yourself.

The command needs Node.js 20 or newer. Agentsims itself does not need Node.js. For more information, see coding agents.

Make sure that it worksCopy Anchor Link

agentsims doctor

If doctor finds a problem, it tells you how to correct it.

Then start the workspace.

UpdateCopy Anchor Link

Install without the skillCopy Anchor Link

To prevent the installer from installing the skill, use one of these options:

curl -fsSL https://agentsims.dev/install | bash -s -- --no-skill

$env:AGENTSIMS_NO_SKILL = "1"; irm https://agentsims.dev/install.ps1 | iex

Install without a change to PATHCopy Anchor Link

The installers add Agentsims to your PATH. To prevent this change, use one of these options:

curl -fsSL https://agentsims.dev/install | bash -s -- --no-modify-path

$env:AGENTSIMS_NO_MODIFY_PATH = "1"; irm https://agentsims.dev/install.ps1 | iex

Then run Agentsims from its full path:

Data locationCopy Anchor Link

Agentsims keeps its logs, screenshots, recordings, and traces in ~/.agentsims. To use another directory, set AGENTSIMS_HOME_DIR.