persitz/pebble-testpilot

pebble-testpilot is a testing and automation tool for developers building apps for the Pebble smartwatch. It is not itself a watch app. Instead, it is a command line tool that installs your built app, a .pbw file, into a real Pebble emulator, then lets you script button presses, touch input, and sensor events, check device logs and on-screen text, take screenshots, and watch the emulator live in a browser. The project describes itself as similar to Playwright, the web browser testing tool, but for Pebble watches. You write a JSON file listing the actions you want to run, such as launching the app, pressing a button, and taking a screenshot, and the tool replays that script and reports back structured results. The same script can be run by a person at a keyboard, by a continuous integration job, or by an AI coding agent. The supported platform is narrow and clearly stated: only the Emery watch model, Pebble Time 2, and the primary tested environment is Debian 12 on aarch64 hardware. On x86_64 Linux, the author suggests using pebble-tool's own built in emulator commands instead, since this project's own tooling is not available there. macOS and Windows are not covered at all. Interestingly, the README states plainly that this tool was built almost entirely by AI coding agents, Claude and Codex, working from human technical direction, with the human not reviewing the code line by line. Despite that, it has already been used to build and ship a real watch app called Timers, which is live on the rePebble app store and has gone through about ten released versions. Because the tool starts local processes, opens network ports, and creates and deletes files on your machine, the author recommends running it inside a container or other disposable environment, and a ready made devcontainer setup is included for that purpose. The project is released under the Apache 2.0 license.