{
  "markdown": "# AureDroid - Advanced Android Control for AI Agents\n\n**AureDroid** (formerly ADB Control Gemini) is a premium **Gemini CLI Extension** and **MCP Server (Model Context Protocol)** that provides superior Android control and automation capabilities for AI agents. It allows models like Gemini to interact with Android devices through ADB, with added intelligence from OpenCV and smart search.\n\n## 🚀 Key Features\n\n- **Smart Element Finding:** Find UI elements extremely fast by text, ID, or description, without needing the AI to parse the full screen XML.\n- **Visual Perception (OpenCV):** Recognize on-screen images using Template Matching. Users can supply a directory of sample images for the AI to perform complex visual tasks (e.g., finding a specific icon or button).\n- **Comprehensive Device Control**: Supports over 100 ADB commands, from basic taps and swipes to advanced actions like file management, logcat, and system settings.\n- **App Management**: Install, debug, list, and manage application packages.\n- **System Monitoring**: Check battery, memory, CPU, temperature, and network status.\n- **Optimized MCP Server**: The server is performance-optimized, loading all commands into memory at startup for fast and stable execution.\n\n## 🛠 System Requirements\n\n- **Node.js**: v18+\n- **Python**: v3.10+\n- **Python Libraries**: `opencv-python`, `numpy`\n- **ADB**: Installed and added to the system's PATH.\n- **Android Device**: USB Debugging mode enabled.\n\n## 📦 Installation\n\n```bash\ngemini extension install https://github.com/tiendung2k03/adb-control-gemini/\n```\n\n### Directory Structure\n- `commands/android/`: Contains ADB command definitions as `.toml` files.\n- `utils/`: Python scripts to support complex ADB logic processing.\n- `mcp-server/`: TypeScript source code of the MCP Server.\n- `dist/`: Compiled JavaScript source code.\n\n## 📝 Typical Command List\n\n| Command | Description |\n|---|---|\n| `connect` | Connect to a device via TCP/IP. |\n| `screenshot` | Take a screenshot of the device. |\n| `smart_finder` | Find a UI element by text or resource-id. |\n| `visual_perception`| Find an image on the screen using a template. |\n| `install` | Install an application from an APK file. |\n| `logcat` | View real-time system logs. |\n| `input_tap` | Simulate a tap at coordinates. |\n\n\n## ✍️ Author\nDeveloped by the AuraDroid Team.\n[Join Channel Telegram](https://t.me/auredroid_channel)\n\n## 👥 Chat\n[Join Group Telegram](https://t.me/auredroid_chat)\n\n## 🤝 Contribution\n\nAll contributions to improve the project are welcome. Please create an **Issue** or send a **Pull Request**.\n\n## 📄 License\n\nThis project is released under the **Apache-2.0** license.\n",
  "bytes": 2663,
  "sha": "247e08c1ce3e011e2ba6fa8e669f65b8cc2dd993b5c55c1b3dce6d2069f13e47",
  "repo_slug": "tiendung2k03/adb-control-gemini",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_tiendung2k03_adb_control_gemini_48b946f0/readme"
}