Terminator

1![Demo](https://github.com/user-attachments/assets/b33212a6-7bd1-4654-b658-8a2f9a3a8b77)
2 
3<p align="center">
4  <a href="https://cdn.crabnebula.app/download/mediar/mediar/latest/platform/windows-x86_64">
5    <img src="https://img.shields.io/badge/Download_for_Windows-0078D4?style=for-the-badge&logo=windows&logoColor=white" alt="Download for Windows" height="50">
6  </a>
7  &nbsp;&nbsp;
8  <a href="https://app.mediar.ai">
9    <img src="https://img.shields.io/badge/Use_on_macOS-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Use on macOS" height="50">
10  </a>
11</p>
12 
13<p align="center">
14  <a href="https://t8r.tech">
15    <img src="https://img.shields.io/badge/Website-t8r.tech-FF3E00?style=flat-square" alt="Website">
16  </a>
17  <a href="https://discord.gg/dU9EBuw7Uq">
18    <img src="https://img.shields.io/discord/823813159592001537?color=5865F2&logo=discord&logoColor=white&style=flat-square" alt="Join us on Discord">
19  </a>
20  <a href="https://www.youtube.com/@mediar_ai">
21    <img src="https://img.shields.io/badge/YouTube-@mediar__ai-FF0000?logo=youtube&logoColor=white&style=flat-square" alt="YouTube @mediar_ai">
22  </a>
23  <a href="https://crates.io/crates/terminator-rs">
24    <img src="https://img.shields.io/crates/v/terminator-rs.svg" alt="Crates.io - terminator-rs">
25  </a>
26  <a href="https://crates.io/crates/terminator-workflow-recorder">
27    <img src="https://img.shields.io/crates/v/terminator-workflow-recorder.svg" alt="Crates.io - workflow recorder">
28  </a>
29</p>
30 
31<p align="center">
32  <a href="https://github.com/mediar-ai/terminator/blob/main/terminator-mcp-agent/README.md#quick-install">
33    <img alt="Install in Cursor" src="https://img.shields.io/badge/Cursor-Cursor?style=flat-square&label=Install%20MCP&color=22272e">
34  </a>
35  <a 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">
36    <img alt="Install in VS Code" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20MCP&color=0098FF">
37  </a>
38  <a 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">
39    <img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20MCP&color=24bfa5">
40  </a>
41</p>
42 
43## Computer Use MCP that controls your entire desktop
44 
45Give AI assistants (Claude, Cursor, VS Code, etc.) the ability to control your desktop and automate tasks across any application.
46 
47**Claude Code (one-liner):**
48```bash
49claude mcp add terminator "npx -y terminator-mcp-agent@latest"
50```
51 
52**Other clients (Cursor, VS Code, Windsurf, etc.):**
53 
54Add to your MCP config file:
55```json
56{
57  "mcpServers": {
58    "terminator-mcp-agent": {
59      "command": "npx",
60      "args": ["-y", "terminator-mcp-agent@latest"],
61      "env": {
62        "LOG_LEVEL": "info",
63        "RUST_BACKTRACE": "1"
64      }
65    }
66  }
67}
68```
69 
70See the [MCP Agent README](https://github.com/mediar-ai/terminator/tree/main/terminator-mcp-agent) for detailed setup instructions.
71 
72### Why Terminator MCP?
73 
74- **Uses your browser session** - no need to relogin, keeps all your cookies and auth
75- **Doesn't take over your cursor or keyboard** - runs in the background without interrupting your work
76- **Works across all dimensions** - pixels, DOM, and Accessibility tree for maximum reliability
77 
78### Use Cases
79 
80- Create a new instance on GCP, connect to it using CLI
81- Check logs on Vercel to find most common errors
82- Test my app new features based on recent commits
83 
84## What's new
85 
86- 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)
87- 10/30 Public alpha is live - [Cursor for Windows automation](https://www.mediar.ai)
88- 09/26 Terminator was on [Cohere Labs podcast](https://www.youtube.com/watch?v=cfQxlk8KNmY), also [check the slides](https://092025-cohere.mediar.ai/)
89- 08/25 Big release — NodeJS SDK in YAML workflows, run JS in browser, OS event recording → YAML generation in MCP, and more
90- 08/25 [we raised $2.8m to give AI hands to every desktop](https://x.com/louis030195/status/1948745185178914929)
91 
92## Why Terminator
93 
94### For Developers
95 
96- Create automations that work across any desktop app or browser
97- Runs 100x faster than ChatGPT Agents, Claude, Perplexity Comet, BrowserBase, BrowserUse (deterministic, CPU speed, with AI recovery)
98- >95% success rate unlike most computer use overhyped products
99- MIT-licensed — fork it, ship it, no lock-in
100 
101We achieve this by pre-training workflows as deterministic code, and calling AI only when recovery is needed.
102 
103### For Teams
104 
105[Our public beta workflow builder](https://www.mediar.ai) + managed hosting:
106 
107- Record, map your processes, and implement the workflow without technical skills
108- Deploy AI to execute them at >95% success rate without managing hundreds of Windows VMs
109- Kill repetitive work without legacy RPA complexity, implementation and maintenance cost
110 
111## Feature Support
112 
113Terminator currently supports **Windows only**. macOS and Linux are not supported.
114 
115| Feature                      | Windows | macOS | Linux | Notes                                                |
116| ---------------------------- | :-----: | :---: | :---: | ---------------------------------------------------- |
117| **Core Automation**          |         |       |       |                                                      |
118| Element Locators             |   Yes   |   No  |   No  | Find elements by `name`, `role`, `window`, etc.      |
119| UI Actions (`click`, `type`) |   Yes   |   No  |   No  | Core interactions with UI elements.                  |
120| Application Management       |   Yes   |   No  |   No  | Launch, list, and manage applications.               |
121| Window Management            |   Yes   |   No  |   No  | Get active window, list windows.                     |
122| **Advanced Features**        |         |       |       |                                                      |
123| Browser Automation           |   Yes   |   No  |   No  | Chrome extension enables browser control.            |
124| Workflow Recording           |   Yes   |   No  |   No  | Record human workflows for deterministic automation. |
125| Monitor Management           |   Yes   |   No  |   No  | Multi-display support.                               |
126| Screen & Element Capture     |   Yes   |   No  |   No  | Take screenshots of displays or elements.            |
127| **Libraries**                |         |       |       |                                                      |
128| Python (`terminator.py`)     | Partial |   No  |   No  | `pip install terminator`                             |
129| TypeScript (`@mediar-ai/terminator`) |   Yes   |   No  |   No  | `npm i @mediar-ai/terminator`                        |
130| Workflow (`@mediar-ai/workflow`) |   Yes   |   No  |   No  | `npm i @mediar-ai/workflow`                          |
131| CLI (`@mediar-ai/cli`)       |   Yes   |   No  |   No  | `npm i @mediar-ai/cli`                               |
132| KV (`@mediar-ai/kv`)         |   Yes   |   No  |   No  | `npm i @mediar-ai/kv`                                |
133| MCP (`terminator-mcp-agent`) |   Yes   |   No  |   No  | `npx -y terminator-mcp-agent --add-to-app [app]`     |
134| Rust (`terminator-rs`)       |   Yes   |   No  |   No  | `cargo add terminator-rs`                            |
135 
136**Legend:**
137 
138- **Yes**: Supported - The feature is stable and well-tested.
139- **Partial**: Partial / Experimental - The feature is in development and may have limitations.
140- **No**: Not available on this platform.
141 
142## How to Inspect Accessibility Elements (like `name:Seven`)
143 
144To create reliable selectors (e.g. `name:Seven`, `role:Button`, `window:Calculator`), you need to inspect the Windows Accessibility Tree:
145 
146### Windows
147 
148- **Tool:** [Accessibility Insights for Windows](https://accessibilityinsights.io/downloads/)
149- **Alt:** [Inspect.exe](https://learn.microsoft.com/en-us/windows/win32/winauto/inspect-objects) (comes with Windows SDK)
150- **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).
151 
152> These tools show you the `Name`, `Role`, `ControlType`, and other metadata used in Terminator selectors.
153 
154### Platform Support
155 
156| Platform | CLI | MCP Agent | Automation | Installation Method |
157|----------|:---:|:---------:|:----------:|---------------------|
158| Windows  | Yes | Yes       | Yes        | npm/bunx |
159 
160**Note:** Terminator currently supports Windows only. macOS and Linux support is not available.
161 
162## Troubleshooting
163 
164For detailed troubleshooting, debugging, and MCP server logs, [send us a message](https://www.mediar.ai/).
165 
166## Contributing
167 
168Contributions are welcome! Please feel free to submit issues and pull requests. many parts are experimental, and help is appreciated. 
169 
170 
171