gitwtfhub

wtf is open-controller?

amazing-things/open-controller — explained in plain English

Analysis updated 2026-05-18

7TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

An OpenCode plugin that lets an AI agent directly click, type, and control a Windows desktop through a separate windows-mcp helper program.

Mindmap

mindmap
  root((repo))
    What it does
      Control desktop UI
      Run PowerShell
      Read and write files
      Take screenshots
    Tech stack
      TypeScript
      OpenCode plugin
      windows-mcp Python server
    Use cases
      Automate desktop tasks via AI
      Run scripts and check results
      Manage files and registry
    Audience
      Developers
      Automation tinkerers
    Setup
      Needs Node.js and Python
      Install via npm and pip

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let an AI coding assistant open and control desktop applications on Windows

REASON 2

Automate repetitive PowerShell or file system tasks through natural language

REASON 3

Have the AI take and analyze screenshots to verify a task completed correctly

REASON 4

Read or modify Windows Registry keys through the agent

What's in the stack?

TypeScriptNode.jsPythonPowerShellOpenCode

How it stacks up

amazing-things/open-controlleradguardteam/ruleseditorarkorlab/haru
Stars777
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-01
MaintenanceActive
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+, Python 3.11+, and the separate windows-mcp Python package.

License details are not stated in the README excerpt.

Wtf does this do

open-controller is a plugin for OpenCode, a coding assistant tool, that lets an AI agent directly control a Windows computer instead of just editing code. It works by connecting to a separate helper program called windows-mcp, which does the actual work of clicking, typing, and reading the screen. Once installed, the AI agent gains the ability to click, type, scroll, drag, and switch between application windows on the desktop, take and read screenshots, read and write files and folders, run PowerShell commands, read and change Windows Registry entries, list or stop running programs, get or set clipboard content, send Windows notifications, fetch and read web pages, and select or edit multiple on screen elements at once. In practice this means you could ask the AI agent to do things like open a program, fill in a form, take a screenshot to check the result, or run a script, all through plain instructions rather than code. Setting it up requires Node.js, OpenCode itself, and Python, since the underlying windows-mcp helper is a Python package installed separately. Installation is a matter of adding the plugin through npm and enabling it in OpenCode's configuration file, then installing the Python package with pip. A notable design detail is that the plugin ships a written set of instructions that it automatically inserts into the AI agent's system prompt every session, covering common mistakes such as the agent acting on the wrong window, typing long text too quickly, or misreading a timeout message as a failure when it was actually just a slow operation. The plugin also raises the normal 30 second timeout most tools use up to 20 hours by default, since some UI automation actions legitimately take a long time, though this can be changed with an environment variable. Starting from a later version, the plugin checks for and installs its own updates automatically each time OpenCode starts, unless this is turned off.

Yoink these prompts

Prompt 1
Help me install the open-controller plugin and windows-mcp so my OpenCode agent can control my Windows desktop
Prompt 2
Explain what the WINDOWS_CONTROLLER.md instructions do and why they get injected into the agent's system prompt
Prompt 3
Walk me through changing the OPENCONTROLLER_MCP_TIMEOUT_MS setting for open-controller
Prompt 4
Show me how to build and use a local development version of open-controller in OpenCode

Frequently asked questions

wtf is open-controller?

An OpenCode plugin that lets an AI agent directly click, type, and control a Windows desktop through a separate windows-mcp helper program.

What language is open-controller written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Python.

What license does open-controller use?

License details are not stated in the README excerpt.

How hard is open-controller to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is open-controller for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.