# AutoMobile

> **⚠️ PROJECT ARCHIVED**
>
> **AutoMobile is no longer maintained or supported by Zillow. Zillow does not provide warranties or support for this project.**
>
> This repository has been archived and is read-only. For continued development and support, please see the community-maintained fork by Jason Pearson:
>
> **🔗 [https://github.com/kaeawc/auto-mobile](https://github.com/kaeawc/auto-mobile)**

---

![AutoMobile sticker](docs/img/auto_mobile_sticker_splash.png)

<a href="https://glama.ai/mcp/servers/@zillow/auto-mobile">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@zillow/auto-mobile/badge" alt="AutoMobile MCP server" />
</a>

AutoMobile is a set of tools for mobile automation. You can use it for UI testing or as a development workflow
assistant.

The first platform supported is Android with plans to extend to iOS.

## How it works

- 🔧 **[Powerful MCP Server](docs/features/mcp-server/index.md)**: AutoMobile provides comprehensive [actions](docs/features/mcp-server/actions.md) through MCP
  tool calls with a fast [observations](docs/features/mcp-server/observation.md) to drive the
  [interaction loop](docs/features/mcp-server/interaction-loop.md).
- 🗺️ **Source Mapping**: Combining project path config with deep view hierarchy analysis we know exactly what code is being rendered.
- ✍️ **[Automated Test Authoring](docs/features/test-authoring/index.md)**: When used in test authoring mode AutoMobile will write tests for you. It is the only way it writes tests.
- 🧪 **[Test Execution](docs/features/test-execution/index.md)** - Run tests locally or on CI without extra infrastructure.
- 📱 **Device Management**: Multi-device support with emulator control and app lifecycle management.

All together you get a system that looks like this:

![automobile_system_design.png](docs/img/automobile_system_design.png)

## Documentation

- 💻 [Installation & Getting Started](docs/installation.md) - AutoMobile is [published on npm](https://www.npmjs.com/package/auto-mobile)
  and we have instructions for agents we've tested with.
- 📝 [Change Log](CHANGELOG.md) - coming soon

## Contributing

- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Responsible disclosure & use](SECURITY.md)
- [Contributing](.github/CONTRIBUTING.md) - coming soon

# Acknowledgement 

By continuing to use AutoMobile, [you acknowledge and agree to the warnings and responsible use requirements](SECURITY.md).