{"id":27775313,"url":"https://github.com/mediar-ai/terminator","last_synced_at":"2026-01-28T00:56:24.341Z","repository":{"id":287312688,"uuid":"964314175","full_name":"mediar-ai/terminator","owner":"mediar-ai","description":"Playwright but for your desktop. Automate your Windows computer in JS or Python. 100x faster and cheaper than OpenAI Operator or Anthropic Computer Use. Not relying on vision","archived":false,"fork":false,"pushed_at":"2025-04-29T19:30:49.000Z","size":1131,"stargazers_count":78,"open_issues_count":4,"forks_count":12,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-30T03:53:37.925Z","etag":null,"topics":["agent","agents","ai","llm","ml","native","py","rust","ts","vercel","vercel-ai-sdk"],"latest_commit_sha":null,"homepage":"https://docs.screenpi.pe/terminator/introduction","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mediar-ai.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}},"created_at":"2025-04-11T02:48:04.000Z","updated_at":"2025-04-30T00:54:10.000Z","dependencies_parsed_at":"2025-04-11T04:23:08.573Z","dependency_job_id":"d18d97b5-5a14-4ef8-9450-0d73fa5a07c7","html_url":"https://github.com/mediar-ai/terminator","commit_stats":null,"previous_names":["mediar-ai/terminator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediar-ai%2Fterminator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediar-ai%2Fterminator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediar-ai%2Fterminator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediar-ai%2Fterminator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mediar-ai","download_url":"https://codeload.github.com/mediar-ai/terminator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251638760,"owners_count":21619663,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["agent","agents","ai","llm","ml","native","py","rust","ts","vercel","vercel-ai-sdk"],"created_at":"2025-04-30T03:53:47.804Z","updated_at":"2026-01-28T00:56:24.332Z","avatar_url":"https://github.com/mediar-ai.png","language":"Rust","funding_links":[],"categories":["AI Agents \u0026 Autonomy Frameworks","Rust","MCP Servers","Coding Agents"],"sub_categories":["Desktop Automation"],"readme":"![Demo](https://github.com/user-attachments/assets/b33212a6-7bd1-4654-b658-8a2f9a3a8b77)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://cdn.crabnebula.app/download/mediar/mediar/latest/platform/windows-x86_64\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/⬇_Download_for_Windows-0078D4?style=for-the-badge\u0026logo=windows\u0026logoColor=white\" alt=\"Download for Windows\" height=\"50\"\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://app.mediar.ai\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/🌐_Use_on_macOS-000000?style=for-the-badge\u0026logo=apple\u0026logoColor=white\" alt=\"Use on macOS\" height=\"50\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/dU9EBuw7Uq\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/823813159592001537?color=5865F2\u0026logo=discord\u0026logoColor=white\u0026style=flat-square\" alt=\"Join us on Discord\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.youtube.com/@mediar_ai\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/YouTube-@mediar__ai-FF0000?logo=youtube\u0026logoColor=white\u0026style=flat-square\" alt=\"YouTube @mediar_ai\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://crates.io/crates/terminator-rs\"\u003e\n    \u003cimg src=\"https://img.shields.io/crates/v/terminator-rs.svg\" alt=\"Crates.io - terminator-rs\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://crates.io/crates/terminator-workflow-recorder\"\u003e\n    \u003cimg src=\"https://img.shields.io/crates/v/terminator-workflow-recorder.svg\" alt=\"Crates.io - workflow recorder\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/mediar-ai/terminator/blob/main/terminator-mcp-agent/README.md#quick-install\"\u003e\n    \u003cimg alt=\"Install in Cursor\" src=\"https://img.shields.io/badge/Cursor-Cursor?style=flat-square\u0026label=Install%20MCP\u0026color=22272e\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22terminator-mcp-agent%22%3A%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22terminator-mcp-agent%22%5D%7D%7D\"\u003e\n    \u003cimg alt=\"Install in VS Code\" src=\"https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square\u0026label=Install%20MCP\u0026color=0098FF\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%7B%22terminator-mcp-agent%22%3A%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22terminator-mcp-agent%22%5D%7D%7D\"\u003e\n    \u003cimg alt=\"Install in VS Code Insiders\" src=\"https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square\u0026label=Install%20MCP\u0026color=24bfa5\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## 🤖 Computer Use MCP that controls your entire desktop\n\nGive AI assistants (Claude, Cursor, VS Code, etc.) the ability to control your desktop and automate tasks across any application.\n\n**Claude Code (one-liner):**\n```bash\nclaude mcp add terminator \"npx -y terminator-mcp-agent@latest\"\n```\n\n**Other clients (Cursor, VS Code, Windsurf, etc.):**\n\nAdd to your MCP config file:\n```json\n{\n  \"mcpServers\": {\n    \"terminator-mcp-agent\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"terminator-mcp-agent@latest\"],\n      \"env\": {\n        \"LOG_LEVEL\": \"info\",\n        \"RUST_BACKTRACE\": \"1\"\n      }\n    }\n  }\n}\n```\n\nSee the [MCP Agent README](https://github.com/mediar-ai/terminator/tree/main/terminator-mcp-agent) for detailed setup instructions.\n\n### Why Terminator MCP?\n\n- **Uses your browser session** - no need to relogin, keeps all your cookies and auth\n- **Doesn't take over your cursor or keyboard** - runs in the background without interrupting your work\n- **Works across all dimensions** - pixels, DOM, and Accessibility tree for maximum reliability\n\n### Use Cases\n\n- Create a new instance on GCP, connect to it using CLI\n- Check logs on Vercel to find most common errors\n- Test my app new features based on recent commits\n\n## 🚀 What's new\n\n- 01/09/26 - Mediar IDE (Cursor for Windows automation) is in public access - [download now](https://cdn.crabnebula.app/download/mediar/mediar/latest/platform/windows-x86_64)\n- 10/30 Public alpha is live - [Cursor for Windows automation](https://www.mediar.ai)\n- 09/26 Terminator was on [Cohere Labs podcast](https://www.youtube.com/watch?v=cfQxlk8KNmY), also [check the slides](https://092025-cohere.mediar.ai/)\n- 08/25 Big release — NodeJS SDK in YAML workflows, run JS in browser, OS event recording → YAML generation in MCP, and more\n- 08/25 [we raised $2.8m to give AI hands to every desktop](https://x.com/louis030195/status/1948745185178914929)\n\n## 🧠 Why Terminator\n\n### For Developers\n\n- Create automations that work across any desktop app or browser\n- Runs 100x faster than ChatGPT Agents, Claude, Perplexity Comet, BrowserBase, BrowserUse (deterministic, CPU speed, with AI recovery)\n- \u003e95% success rate unlike most computer use overhyped products\n- MIT-licensed — fork it, ship it, no lock-in\n\nWe achieve this by pre-training workflows as deterministic code, and calling AI only when recovery is needed.\n\n### For Teams\n\n[Our public beta workflow builder](https://www.mediar.ai) + managed hosting:\n\n- Record, map your processes, and implement the workflow without technical skills\n- Deploy AI to execute them at \u003e95% success rate without managing hundreds of Windows VMs\n- Kill repetitive work without legacy RPA complexity, implementation and maintenance cost\n\n## Feature Support\n\nTerminator currently supports **Windows only**. macOS and Linux are not supported.\n\n| Feature                      | Windows | macOS | Linux | Notes                                                |\n| ---------------------------- | :-----: | :---: | :---: | ---------------------------------------------------- |\n| **Core Automation**          |         |       |       |                                                      |\n| Element Locators             |    ✅    |   ❌   |   ❌   | Find elements by `name`, `role`, `window`, etc.      |\n| UI Actions (`click`, `type`) |    ✅    |   ❌   |   ❌   | Core interactions with UI elements.                  |\n| Application Management       |    ✅    |   ❌   |   ❌   | Launch, list, and manage applications.               |\n| Window Management            |    ✅    |   ❌   |   ❌   | Get active window, list windows.                     |\n| **Advanced Features**        |         |       |       |                                                      |\n| Browser Automation           |    ✅    |   ❌   |   ❌   | Chrome extension enables browser control.            |\n| Workflow Recording           |    ✅    |   ❌   |   ❌   | Record human workflows for deterministic automation. |\n| Monitor Management           |    ✅    |   ❌   |   ❌   | Multi-display support.                               |\n| Screen \u0026 Element Capture     |    ✅    |   ❌   |   ❌   | Take screenshots of displays or elements.            |\n| **Libraries**                |         |       |       |                                                      |\n| Python (`terminator.py`)     |    🟡    |   ❌   |   ❌   | `pip install terminator`                             |\n| TypeScript (`@mediar-ai/terminator`) |    ✅    |   ❌   |   ❌   | `npm i @mediar-ai/terminator`                        |\n| Workflow (`@mediar-ai/workflow`) |    ✅    |   ❌   |   ❌   | `npm i @mediar-ai/workflow`                          |\n| CLI (`@mediar-ai/cli`)       |    ✅    |   ❌   |   ❌   | `npm i @mediar-ai/cli`                               |\n| KV (`@mediar-ai/kv`)         |    ✅    |   ❌   |   ❌   | `npm i @mediar-ai/kv`                                |\n| MCP (`terminator-mcp-agent`) |    ✅    |   ❌   |   ❌   | `npx -y terminator-mcp-agent --add-to-app [app]`     |\n| Rust (`terminator-rs`)       |    ✅    |   ❌   |   ❌   | `cargo add terminator-rs`                            |\n\n**Legend:**\n\n- ✅: **Supported** - The feature is stable and well-tested.\n- 🟡: **Partial / Experimental** - The feature is in development and may have limitations.\n- ❌: **Not Supported** - Not available on this platform.\n\n## 🕵️ How to Inspect Accessibility Elements (like `name:Seven`)\n\nTo create reliable selectors (e.g. `name:Seven`, `role:Button`, `window:Calculator`), you need to inspect the Windows Accessibility Tree:\n\n### Windows\n\n- **Tool:** [Accessibility Insights for Windows](https://accessibilityinsights.io/downloads/)\n- **Alt:** [Inspect.exe](https://learn.microsoft.com/en-us/windows/win32/winauto/inspect-objects) (comes with Windows SDK)\n- **Usage:** Open the app you want to inspect → launch Accessibility Insights → hover or use keyboard navigation to explore the UI tree (Name, Role, ControlType, AutomationId).\n\n\u003e These tools show you the `Name`, `Role`, `ControlType`, and other metadata used in Terminator selectors.\n\n### Platform Support\n\n| Platform | CLI | MCP Agent | Automation | Installation Method |\n|----------|:---:|:---------:|:----------:|---------------------|\n| Windows  | ✅  | ✅        | ✅         | npm/bunx |\n\n**Note:** Terminator currently supports Windows only. macOS and Linux support is not available.\n\n## Troubleshooting\n\nFor detailed troubleshooting, debugging, and MCP server logs, [send us a message](https://www.mediar.ai/).\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues and pull requests. many parts are experimental, and help is appreciated. \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmediar-ai%2Fterminator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmediar-ai%2Fterminator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmediar-ai%2Fterminator/lists"}