https://github.com/mediar-ai/terminator
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
https://github.com/mediar-ai/terminator
agent agents ai llm ml native py rust ts vercel vercel-ai-sdk
Last synced: 2 months ago
JSON representation
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
- Host: GitHub
- URL: https://github.com/mediar-ai/terminator
- Owner: mediar-ai
- License: other
- Created: 2025-04-11T02:48:04.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-29T19:30:49.000Z (11 months ago)
- Last Synced: 2025-04-30T03:53:37.925Z (11 months ago)
- Topics: agent, agents, ai, llm, ml, native, py, rust, ts, vercel, vercel-ai-sdk
- Language: Rust
- Homepage: https://docs.screenpi.pe/terminator/introduction
- Size: 1.08 MB
- Stars: 78
- Watchers: 2
- Forks: 12
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp - mediar-ai/terminator - Terminator is an open-source automation tool for Windows that leverages the Model Context Protocol to enable AI-driven desktop and browser automation with high reliability and speed. (MCP Servers / Desktop Automation)
- best-of-mcp-servers - GitHub - 1% open · ⏱️ 17.03.2026) (Coding Agents)
README
## 🤖 Computer Use MCP that controls your entire desktop
Give AI assistants (Claude, Cursor, VS Code, etc.) the ability to control your desktop and automate tasks across any application.
**Claude Code (one-liner):**
```bash
claude mcp add terminator "npx -y terminator-mcp-agent@latest"
```
**Other clients (Cursor, VS Code, Windsurf, etc.):**
Add to your MCP config file:
```json
{
"mcpServers": {
"terminator-mcp-agent": {
"command": "npx",
"args": ["-y", "terminator-mcp-agent@latest"],
"env": {
"LOG_LEVEL": "info",
"RUST_BACKTRACE": "1"
}
}
}
}
```
See the [MCP Agent README](https://github.com/mediar-ai/terminator/tree/main/terminator-mcp-agent) for detailed setup instructions.
### Why Terminator MCP?
- **Uses your browser session** - no need to relogin, keeps all your cookies and auth
- **Doesn't take over your cursor or keyboard** - runs in the background without interrupting your work
- **Works across all dimensions** - pixels, DOM, and Accessibility tree for maximum reliability
### Use Cases
- Create a new instance on GCP, connect to it using CLI
- Check logs on Vercel to find most common errors
- Test my app new features based on recent commits
## 🚀 What's new
- 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)
- 10/30 Public alpha is live - [Cursor for Windows automation](https://www.mediar.ai)
- 09/26 Terminator was on [Cohere Labs podcast](https://www.youtube.com/watch?v=cfQxlk8KNmY), also [check the slides](https://092025-cohere.mediar.ai/)
- 08/25 Big release — NodeJS SDK in YAML workflows, run JS in browser, OS event recording → YAML generation in MCP, and more
- 08/25 [we raised $2.8m to give AI hands to every desktop](https://x.com/louis030195/status/1948745185178914929)
## 🧠 Why Terminator
### For Developers
- Create automations that work across any desktop app or browser
- Runs 100x faster than ChatGPT Agents, Claude, Perplexity Comet, BrowserBase, BrowserUse (deterministic, CPU speed, with AI recovery)
- >95% success rate unlike most computer use overhyped products
- MIT-licensed — fork it, ship it, no lock-in
We achieve this by pre-training workflows as deterministic code, and calling AI only when recovery is needed.
### For Teams
[Our public beta workflow builder](https://www.mediar.ai) + managed hosting:
- Record, map your processes, and implement the workflow without technical skills
- Deploy AI to execute them at >95% success rate without managing hundreds of Windows VMs
- Kill repetitive work without legacy RPA complexity, implementation and maintenance cost
## Feature Support
Terminator currently supports **Windows only**. macOS and Linux are not supported.
| Feature | Windows | macOS | Linux | Notes |
| ---------------------------- | :-----: | :---: | :---: | ---------------------------------------------------- |
| **Core Automation** | | | | |
| Element Locators | ✅ | ❌ | ❌ | Find elements by `name`, `role`, `window`, etc. |
| UI Actions (`click`, `type`) | ✅ | ❌ | ❌ | Core interactions with UI elements. |
| Application Management | ✅ | ❌ | ❌ | Launch, list, and manage applications. |
| Window Management | ✅ | ❌ | ❌ | Get active window, list windows. |
| **Advanced Features** | | | | |
| Browser Automation | ✅ | ❌ | ❌ | Chrome extension enables browser control. |
| Workflow Recording | ✅ | ❌ | ❌ | Record human workflows for deterministic automation. |
| Monitor Management | ✅ | ❌ | ❌ | Multi-display support. |
| Screen & Element Capture | ✅ | ❌ | ❌ | Take screenshots of displays or elements. |
| **Libraries** | | | | |
| Python (`terminator.py`) | 🟡 | ❌ | ❌ | `pip install terminator` |
| TypeScript (`@mediar-ai/terminator`) | ✅ | ❌ | ❌ | `npm i @mediar-ai/terminator` |
| Workflow (`@mediar-ai/workflow`) | ✅ | ❌ | ❌ | `npm i @mediar-ai/workflow` |
| CLI (`@mediar-ai/cli`) | ✅ | ❌ | ❌ | `npm i @mediar-ai/cli` |
| KV (`@mediar-ai/kv`) | ✅ | ❌ | ❌ | `npm i @mediar-ai/kv` |
| MCP (`terminator-mcp-agent`) | ✅ | ❌ | ❌ | `npx -y terminator-mcp-agent --add-to-app [app]` |
| Rust (`terminator-rs`) | ✅ | ❌ | ❌ | `cargo add terminator-rs` |
**Legend:**
- ✅: **Supported** - The feature is stable and well-tested.
- 🟡: **Partial / Experimental** - The feature is in development and may have limitations.
- ❌: **Not Supported** - Not available on this platform.
## 🕵️ How to Inspect Accessibility Elements (like `name:Seven`)
To create reliable selectors (e.g. `name:Seven`, `role:Button`, `window:Calculator`), you need to inspect the Windows Accessibility Tree:
### Windows
- **Tool:** [Accessibility Insights for Windows](https://accessibilityinsights.io/downloads/)
- **Alt:** [Inspect.exe](https://learn.microsoft.com/en-us/windows/win32/winauto/inspect-objects) (comes with Windows SDK)
- **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).
> These tools show you the `Name`, `Role`, `ControlType`, and other metadata used in Terminator selectors.
### Platform Support
| Platform | CLI | MCP Agent | Automation | Installation Method |
|----------|:---:|:---------:|:----------:|---------------------|
| Windows | ✅ | ✅ | ✅ | npm/bunx |
**Note:** Terminator currently supports Windows only. macOS and Linux support is not available.
## Troubleshooting
For detailed troubleshooting, debugging, and MCP server logs, [send us a message](https://www.mediar.ai/).
## Contributing
Contributions are welcome! Please feel free to submit issues and pull requests. many parts are experimental, and help is appreciated.