Want a turnkey automation? mediar.ai
Want No code workflow builder? app.mediar.ai
๐ฐ Bounty Developer Program
We have listed a few issues with bounties - ask questions, complete tasks, make money!
Check out our bounty-tagged issues and start contributing today:
Join our Discord to discuss bounties and get help getting started.
demo of terminator drawing in paint
https://github.com/user-attachments/assets/b7bec5df-64a9-4f0e-aba4-1578c11275c7
๐ What's new
- 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 โ
๐ง 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 + 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
Platform installation method
| Platform | CLI | MCP Agent | Automation | Installation Method |
|---|---|---|---|---|
| Windows | โ | โ | โ | npm/bunx |
| macOS | ๐ก | ๐ก | ๐ก | Compile from source |
| Linux | ๐ก | ๐ก | ๐ก | Compile from source |
๐ฅ Installation for technical users
Terminator CLI
Windows (Recommended):
# Run directly without installation
npx @mediar-ai/cli --help
bunx @mediar-ai/cli --help
# Or install globally
npm install -g @mediar-ai/cli
macOS / Linux (Experimental - Compile from Source):
โ ๏ธ Warning: macOS and Linux support is experimental. Many features are Windows-only or incomplete on other platforms.
git clone https://github.com/mediar-ai/terminator
cd terminator
cargo build --release
# Binary at: ./target/release/terminator
๐ค Want AI Automation with Claude Code?
Install the Terminator MCP in Claude Code:
claude mcp add terminator "npx -y terminator-mcp-agent@latest" -s user
Or install via the MCP directory for other clients (Cursor, VS Code, etc.).
What this does: Gives AI assistants the ability to control your desktop and automate tasks across any application.
Feature Support
While Terminator aims for full cross-platform support, current capabilities vary by OS. Windows is the primary development target and has the most complete feature set.
| 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 - The feature is not yet 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 Accessibility Tree of your OS. Here's how to explore UI elements on each platform:
๐ช Windows
- 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.
๐ macOS
- Tool: Accessibility Inspector
- Usage: Comes with Xcode โ Open
Xcode > Open Developer Tool > Accessibility Inspectorโ Use the target icon to explore UI elements on screen.
๐ง Linux
Tool: Accerciser
Install:
sudo apt install accerciserUsage: Launch Accerciser โ Select the window/app โ Browse the accessible widget tree.
Troubleshooting
For detailed troubleshooting, debugging, and MCP server logs, send us a message.
Contributing
Contributions are welcome! Please feel free to submit issues and pull requests. many parts are experimental, and help is appreciated.
