Skip to content

mediar-ai/terminator

Repository files navigation

πŸ’° 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

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

🧠 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 accerciser
  • Usage: 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.