
jeremywangcy/win-pilot
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Agent-neutral Windows Computer Use plugin with MCP, CLI, skills, and native host adapters
Обзор
Win-Pilot provides Windows computer use with DeepSeek Harness as its primary integration. Its computer tool operates in the current desktop or an optional separate Windows task session, with a compact visible window for pause and manual takeover. Plugin, MCP, CLI and native integrations share the same runtime. - Windows 10/11 x64 - Node.js 22.12 or newer - Windows PowerShell 5.1 - Optional .NET 8 runtime for WGC capture - .NET 8 Windows Desktop Runtime for the optional task desktop - An Agent Plugin host, stdio MCP client, or shell-capable agent Send this single instruction to an agent on the Windows machine: The agent will prefer the complete plugin, then fall back to MCP or CLI only when its host lacks plugin support. Plugin-capable hosts can install JeremyWangCY/win-pilot. The package contains both .mcp.json and skills/win-pilot.
README
Показан фрагмент оригинального README. Открыть оригинал.
win-pilot
English | 中文
Win-Pilot provides Windows computer use with DeepSeek Harness as its primary integration. Its computer tool operates in the current desktop or an optional separate Windows task session, with a compact visible window for pause and manual takeover. Plugin, MCP, CLI and native integrations share the same runtime.
Features
| Feature | Concrete behavior |
|---|---|
| Agent Plugin package | .codex-plugin/plugin.json bundles the MCP server and operating skill |
| Native Windows control | UI Automation, Win32 input/window management, and window-scoped screenshots |
| Background-first actions | Supported capture and input paths avoid unnecessary focus stealing |
| Isolated browser control | Launches Edge sessions and controls them through CDP-bound targets and tokens |
| Recoverable protocol | Stable ok, outcome, error_code, post-action observations, and unknown-outcome handling |
| Universal fallbacks | Local stdio MCP for tool-aware agents; JSON CLI plus skill for shell-capable agents |
| Schema portability | Tool schema is validated for OpenAI- and Gemini-family consumers |
| DSH provider lifecycle | Requires DSH 0.2.0-rc.2+ for Config forms; claims the exclusive computerUse provider slot |
| Optional task desktop | Windows child session with a compact 432×300 frameless window and automatic manual takeover |
Requirements
- Windows 10/11 x64
- Node.js 22.12 or newer
- Windows PowerShell 5.1
- Optional .NET 8 runtime for WGC capture
- .NET 8 Windows Desktop Runtime for the optional task desktop
- An Agent Plugin host, stdio MCP client, or shell-capable agent
Quick Start
Install with your Agent (recommended)
Send this single instruction to an agent on the Windows machine:
Install and verify Win-Pilot by following https://raw.githubusercontent.com/JeremyWangCY/win-pilot/main/AGENT_INSTALL.md
The agent will prefer the complete plugin, then fall back to MCP or CLI only when its host lacks plugin support.
Manual installation
Plugin-capable hosts can install JeremyWangCY/win-pilot. The package contains both .mcp.json and skills/win-pilot.
For other hosts:
npm install -g win-pilot@latest
win-pilot doctor --probe
Register this local MCP server through the host’s normal plugin/tool settings:
{
"mcpServers": {
"win-pilot": { "command": "win-pilot", "args": ["mcp"] }
}
}
Convenience installers are provided for known hosts, while generic modes remain available for every other agent:
win-pilot install --agent codex
win-pilot install --agent claude
win-pilot install --agent qoder
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"win-pilot": { "command": "win-pilot", "args": ["mcp"] }
}
}