Give AI assistants (Claude, Cursor, VS Code, etc.) the ability to control your desktop and automate tasks across any application.
Claude Code (one-liner):
claude mcp add terminator "npx -y terminator-mcp-agent@latest"Other clients (Cursor, VS Code, Windsurf, etc.):
Add to your MCP config file:
{
"mcpServers": {
"terminator-mcp-agent": {
"command": "npx",
"args": ["-y", "terminator-mcp-agent@latest"],
"env": {
"LOG_LEVEL": "info",
"RUST_BACKTRACE": "1"
}
}
}
}See the MCP Agent README for detailed setup instructions.
- 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
- 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
- 10/30 Public alpha is live - n8n for legacy software
- 09/26 Terminator was on Cohere Labs podcast, also check the slides
- 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
- 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.
Our public beta workflow builder + 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
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.
To create reliable selectors (e.g. name:Seven, role:Button, window:Calculator), you need to inspect the Windows Accessibility Tree:
- Tool: Accessibility Insights for Windows
- Alt: Inspect.exe (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 | CLI | MCP Agent | Automation | Installation Method |
|---|---|---|---|---|
| Windows | β | β | β | npm/bunx |
Note: Terminator currently supports Windows only. macOS and Linux support is not available.
For detailed troubleshooting, debugging, and MCP server logs, send us a message.
Contributions are welcome! Please feel free to submit issues and pull requests. many parts are experimental, and help is appreciated.
