{"id":34851121,"url":"https://github.com/annurdien/sim-cli","last_synced_at":"2026-05-15T16:34:58.965Z","repository":{"id":305641965,"uuid":"1023449731","full_name":"annurdien/sim-cli","owner":"annurdien","description":"📱 CLI tool to manage iOS and Android simulators","archived":false,"fork":false,"pushed_at":"2025-07-25T16:53:39.000Z","size":142,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-27T04:15:05.210Z","etag":null,"topics":["adb","android","cli","emulator","ios","simulator","xcrun"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/annurdien.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-07-21T07:22:39.000Z","updated_at":"2025-08-05T11:53:11.000Z","dependencies_parsed_at":"2025-07-21T09:43:27.790Z","dependency_job_id":null,"html_url":"https://github.com/annurdien/sim-cli","commit_stats":null,"previous_names":["annurdien/sim-cli"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/annurdien/sim-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/annurdien%2Fsim-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/annurdien%2Fsim-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/annurdien%2Fsim-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/annurdien%2Fsim-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/annurdien","download_url":"https://codeload.github.com/annurdien/sim-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/annurdien%2Fsim-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33072584,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["adb","android","cli","emulator","ios","simulator","xcrun"],"created_at":"2025-12-25T19:17:24.349Z","updated_at":"2026-05-15T16:34:58.947Z","avatar_url":"https://github.com/annurdien.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SIM-CLI\n\n[![Test and Build](https://github.com/annurdien/sim-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/annurdien/sim-cli/actions/workflows/ci.yml)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/annurdien/sim-cli)](https://golang.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/cli.png\" alt=\"SIM-CLI Terminal Icon\" width=\"600\"\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eiOS Simulator \u0026 Android Emulator Manager\u003c/strong\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\n    A powerful, cross-platform command-line tool to streamline your mobile development workflow.\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## Overview\n\nSIM-CLI provides a simple and unified interface to manage your iOS simulators and Android emulators. Say goodbye to tedious GUI interactions and manage your devices directly from the terminal.\n\n## ✨ Features\n\n- **📱 Device Management**: List, start, stop, shutdown, restart, and delete simulators/emulators.\n- **📸 Media Capture**: Take screenshots and record screen activity with ease.\n- **📋 Clipboard Integration**: Copy screenshots and recordings directly to your clipboard.\n- **GIF Conversion**: Automatically convert screen recordings to GIFs.\n- **🚀 Cross-Platform**: Works on macOS (with full iOS simulator support) and Linux/Windows (Android emulators only).\n- **⌨️ User-Friendly**: Clean, intuitive CLI interface with helpful error messages.\n- **⚡️ Shorthand Commands**: Quick aliases for all commands (e.g., `l` for list, `s` for start).\n- **🧠 Smart Device Selection**: Easily start the last used device.\n\n## 🛠️ Installation\n\n### Prerequisites\n\n- **For iOS simulators**: macOS with Xcode installed.\n- **For Android emulators**: Android SDK with `adb` and `emulator` tools in your PATH.\n\n### Build from Source\n\n```bash\ngit clone https://github.com/annurdien/sim-cli.git\ncd sim-cli\nmake build\n```\n\n### Install\n\n```bash\nmake install\n```\n\n## 🚀 Usage\n\n### Quick Start\n\n```bash\n# List all available devices\nsim list\n\n# Start a device by name\nsim start \"iPhone 15 Pro\"\n\n# Take a screenshot and copy it to the clipboard\nsim screenshot \"iPhone 15 Pro\" --copy\n\n# Record a 10-second GIF\nsim record \"iPhone 15 Pro\" --duration 10 --gif\n\n# Stop the device\nsim stop \"iPhone 15 Pro\"\n```\n\n## 📚 Commands Reference\n\nHere is a complete list of available commands and their options.\n\n| Command | Aliases | Description |\n|---|---|---|\n| `list` | `l`, `ls` | List all available simulators and emulators. |\n| `start \u003cdevice\u003e` | `s` | Start a simulator or emulator. Use `lts` to start the last used device. |\n| `stop \u003cdevice\u003e` | `st` | Stop a running simulator or emulator. |\n| `shutdown \u003cdevice\u003e` | `sd` | Shutdown a simulator or emulator. |\n| `restart \u003cdevice\u003e` | `r` | Restart a simulator or emulator. |\n| `delete \u003cdevice\u003e` | `d`, `del` | **Permanently** delete a simulator or emulator. |\n| `screenshot \u003cdevice\u003e [file]` | `ss`, `shot` | Take a screenshot of a device. |\n| `record \u003cdevice\u003e [file]` | `rec` | Record screen activity of a device. |\n| `last` | - | Show the last used device. |\n| `lts` | - | A shorthand to start the last used device (`sim start lts`). |\n| `help` | - | Show help information. |\n| `version` | `-v` | Show version information. |\n\n### `screenshot` Options\n\n| Flag | Shorthand | Description |\n|---|---|---|\n| `--copy` | `-c` | Copy the screenshot to the clipboard. |\n\n### `record` Options\n\n| Flag | Shorthand | Description |\n|---|---|---|\n| `--duration` | `-d` | Duration of the recording in seconds (e.g., `--duration 15`). |\n| `--gif` | `-g` | Convert the recording to a GIF. |\n| `--copy` | `-c` | Copy the recording file path to the clipboard. |\n\n\n## ⚠️ Safety \u0026 Best Practices\n\n### Delete Command\n\nThe `delete` command is destructive and **permanently removes** the simulator or emulator.\n\n- Always double-check the device name or UDID with `sim list` before deleting.\n- Running devices are automatically stopped before deletion.\n- Deleted devices must be recreated through Xcode (for iOS) or the AVD Manager (for Android).\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a pull request.\n\n1.  Fork the repository.\n2.  Create your feature branch (`git checkout -b feature/AmazingFeature`).\n3.  Commit your changes (`git commit -m 'Add some AmazingFeature'`).\n4.  Push to the branch (`git push origin feature/AmazingFeature`).\n5.  Open a pull request.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fannurdien%2Fsim-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fannurdien%2Fsim-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fannurdien%2Fsim-cli/lists"}