Skip to content

owuzo/terminator

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

demo of terminator drawing in paint

Cursorful.Video.6.1.mp4

Join us on Discord YouTube @mediar_ai Crates.io - terminator-rs Crates.io - workflow recorder

Install in Cursor Install in VS Code Install in VS Code Insiders

πŸš€ What's new

AI-first data entry automation in legacy systems

🧠 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
  • >95% success rate without costly consultant armies (UIPath, Automation Anywhere)
  • 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 = n8n for data entry automation in legacy systems:

  • Record & map your processes in 5 mins
  • Deploy AI to execute them at >95% success rate
  • Kill repetitive work without legacy RPA complexity or cost

🎯 Choose Your Path

πŸ€– Want AI Automation with Claude Code? (Recommended for Most Users)

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.

To create workflows, please download the desktop app.

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.
Language Bindings
Python (terminator.py) 🟑 🟑 🟑 pip install terminator
TypeScript (@mediar-ai/terminator) βœ… βœ… βœ… npm i @mediar-ai/terminator
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 accerciser
  • Usage: Launch Accerciser β†’ Select the window/app β†’ Browse the accessible widget tree.


Explore Further

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.

About

playwright for desktop automation

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 85.4%
  • JavaScript 9.5%
  • TypeScript 2.5%
  • Python 1.2%
  • PowerShell 0.7%
  • Ruby 0.4%
  • Other 0.3%