{"id":31743102,"url":"https://github.com/tornikegomareli/simtouch","last_synced_at":"2026-07-11T16:31:06.921Z","repository":{"id":316489609,"uuid":"1063611453","full_name":"tornikegomareli/simtouch","owner":"tornikegomareli","description":"Send taps, swipes, and gestures to iOS Simulator from command line - built for LLM-driven testing","archived":false,"fork":false,"pushed_at":"2025-09-24T21:47:02.000Z","size":16,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T04:29:20.519Z","etag":null,"topics":["ai-testing","send-actions","send-taps","simulator"],"latest_commit_sha":null,"homepage":"","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tornikegomareli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-24T21:45:23.000Z","updated_at":"2025-11-16T12:37:44.000Z","dependencies_parsed_at":"2025-09-24T23:33:42.792Z","dependency_job_id":"9e798727-26ef-4a03-b085-606a4ecebb64","html_url":"https://github.com/tornikegomareli/simtouch","commit_stats":null,"previous_names":["tornikegomareli/simtouch"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/tornikegomareli/simtouch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tornikegomareli%2Fsimtouch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tornikegomareli%2Fsimtouch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tornikegomareli%2Fsimtouch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tornikegomareli%2Fsimtouch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tornikegomareli","download_url":"https://codeload.github.com/tornikegomareli/simtouch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tornikegomareli%2Fsimtouch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35368766,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-testing","send-actions","send-taps","simulator"],"created_at":"2025-10-09T11:25:48.791Z","updated_at":"2026-07-11T16:31:06.916Z","avatar_url":"https://github.com/tornikegomareli.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"Simple command line tool for sending touch events to iOS Simulator.\n\nCurrntly Support for tap, swipe, and long press\n\n## Installation\n\n### Quick Install (Recommended)\n\nClone and install globally:\n```bash\ngit clone https://github.com/yourusername/simtouch.git\ncd simtouch\n./install.sh\n```\n\nThis will:\n1. Build simtouch with optimizations\n2. Install it to `/usr/local/bin`\n3. Make it available globally as `simtouch`\n\n### Manual Build\n\nIf you prefer to build without installing globally:\n```bash\ngit clone https://github.com/yourusername/simtouch.git\ncd simtouch\nzig build -Doptimize=ReleaseSafe\n```\n\nThe binary will be at `./zig-out/bin/simtouch`\n\n## Usage\n\nMake sure iOS Simulator is running before using simtouch.\n\n### Usage\n\n#### Tap\nSend a single tap at specific coordinates:\n```bash\nsimtouch tap 200 300\n```\n\n#### Swipe\nPerform a swipe gesture from one point to another:\n```bash\nsimtouch swipe 100 500 100 100\n```\n\n#### Long Press\nHold a touch for a specified duration (in milliseconds):\n```bash\nsimtouch longpress 200 200 2000\n```\n\n### Coordinate System\n\n- Coordinates are in pixels relative to the simulator window\n- (0, 0) is the top-left corner of the device screen\n- Example: iPhone 14 Pro is typically 393x852 pixels\n\n## Why\n\nThe main idea behind it is to create a simple, lightweight tool that can be easily integrated with AI/LLM workflows through tool calling. I don't want to use complex automation frameworks, so this simple solution provides a minimal interface that LLMs can directly invoke to interact with.\n\n### Use Cases\n- **AI Testing** - Let LLMs explore and test your iOS apps autonomously\n- Fuzzing Agents - Where a couple of agents are interacting the app simultaneously\n\n## How\n\nsimtouch uses C's Core Graphics APIs to send mouse events to the Simulator window. The iOS Simulator automatically translates these mouse events into touch events for the running iOS application.\n\n```\nCGEvent (Mouse) → Simulator.app → UITouch → iOS App\n```\n\n## Examples\n\n### Automation Script\n```bash\n#!/bin/bash\n# Tap a button\nsimtouch tap 200 400\n\n# Wait\nsleep 1\n\n# Swipe up\nsimtouch swipe 200 600 200 200\n\n# Long press for context menu\nsimtouch longpress 150 300 1500\n```\n\n### Python Integration\n```python\nimport subprocess\n\ndef tap(x, y):\n    subprocess.run([\"simtouch\", \"tap\", str(x), str(y)])\n\ndef swipe(x1, y1, x2, y2):\n    subprocess.run([\"simtouch\", \"swipe\", \n                    str(x1), str(y1), str(x2), str(y2)])\n\n# Example usage\ntap(200, 300)\nswipe(100, 500, 100, 100)\n```\n\n### Building with optimizations\n```bash\nzig build -Doptimize=ReleaseSafe\n```\n\n## Limitations\n- Requires Simulator window to be visible\n- Single touch only (no multi-touch gestures yet)\n\n## Roadmap\n- [ ] Multi-touch support (pinch, rotate)\n- [ ] Element finding by accessibility label\n- [ ] Record and replay functionality\n\n## License\nMIT License - see [LICENSE](LICENSE) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftornikegomareli%2Fsimtouch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftornikegomareli%2Fsimtouch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftornikegomareli%2Fsimtouch/lists"}