EXTRA - Native Computer Use

Extra

The Open-Source Astra 6 for your Linux PC, Mac & Windows

Your AI can see, click, type, navigate, and get real work done on Linux, macOS & Windows.

Website • Quickstart • Linux Guide • macOS Guide • Architecture • License

---

What is Extra and Why Does It Exist?

Extra is an open-source Computer Use protocol and Model Context Protocol (MCP) server developed by yantraOS. It bridges LLMs (including ChatGPT, Claude, Cursor, and Gemini) directly to physical desktop operating systems across Linux, macOS, and Windows. Extra replaces fragile vision-only screenshot loops with native OS accessibility trees and sub-3ms GPU frame streaming, delivering pixel-perfect clicking, instant typing, and up to 225× lower token costs.

Today's AI assistants can write brilliant essays and code, but they are trapped inside a chat window. When you need them to click a button, open an app, organize your files, or input data into a spreadsheet, they can only give you text instructions.

Extra gives your AI hands and eyes on Linux, macOS & Windows.

It connects Claude, Google Antigravity, Cursor, AGY, or any autonomous agent directly to your desktop with high-speed screen vision, pixel-perfect clicking, and instant typing.

• No clunky browser extensions.
• No expensive cloud servers watching your screen.
• 100% open source, local, and private.

---

What Can an AI Assistant Do With Extra?

Once Extra is running, you can talk to your AI like a real human assistant sitting at your desk:

• 📊 Spreadsheets & Data: *"Open Excel or LibreOffice Calc, calculate total revenue from the invoice CSVs in my Downloads folder, and create a summary chart."*
• 🗂️ Desktop & File Cleanup: *"Clean up my messy desktop by moving screenshots into Pictures, PDFs into Documents, and deleting empty folders."*
• 🌐 Web Research & Data Entry: *"Open Chrome or Firefox, find the top 5 flights to Tokyo under $800, and copy their flight numbers and dates into a text note."*
• ⚙️ System Administration: *"Open Settings or terminal, check system updates, and verify service health."*
• 🎵 App Control: *"Launch Spotify or VLC, search for low-fi focus beats, and start playing."*

---

⚡ Quickstart (Under 10 Seconds)

You can set up Extra in seconds on Windows, macOS, or Linux:

Option A: 1-Click Cursor Install (Zero Terminal)

If you use Cursor IDE, install Extra with a single click via the native deeplink:

👉 [Add Extra to Cursor (1-Click Install)](cursor://anysphere.cursor-deeplink/mcp/install?name=extra&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJleHRyYS1kZXNrdG9wIl19)

Cursor will prompt: *"Install MCP Server 'extra' with command 'uvx extra-desktop'?"* — click Install and you're ready!

---

Option B: Automated One-Liner (Configures All Clients Simultaneously)

The one-liner downloads the lightweight core engine (< 6.3 MB) and automatically configures Cursor, Claude Desktop, Windsurf, Claude Code, and Antigravity with zero JSON editing:

• 🪟 Windows PowerShell:

  irm https://extra.yantraos.com/install.ps1 | iex

• 🍏 macOS Terminal:

  curl -sSL https://extra.yantraos.com/install.sh | bash

Or ask your AI on macOS directly:

  Setup Extra on my Mac: In Terminal run 'curl -sSL https://extra.yantraos.com/install.sh | bash', then read and configure ~/.extra/app/STARTER_PROMPT_MACOS.md so we are ready to use Extra.

• 🐧 Linux Terminal (Arch / yantraOS, Ubuntu, Debian, Fedora):

  curl -fsSL https://extra.yantraos.com/install.sh | bash

The automated installer will:

• Verify OS architecture (Windows 10/11 64-bit, macOS 12.3+, or Linux Wayland/X11).
• Provision isolated Python runtime (~/.extra/venv) in under 3 seconds.
• Auto-detect and wire Cursor, Claude Desktop, Windsurf, Claude Code CLI, and Antigravity (agy).
• Run the health diagnostic doctor and confirm readiness.

---

Option C: Instant Zero-Install Runner (uvx / npx)

Run Extra instantly without installing or configuring local venvs:

# Via Astral uv (sub-second cold start):

uvx extra-desktop run

Or via Node npx:

npx -y @yantraos/extra-desktop

---

🎯 Your First 3 Missions

Once Extra is connected, paste any of these 3 verified starter missions into your AI to verify its hands and eyes:

1. 🪄 The Desktop Magic Trick (Window Snap + Notepad Haiku):

*"Snap my active window to the left, open Notepad on the right, and write a haiku about autonomous desktop agents."*

1. 🧮 The Fast Calculator (Sub-3ms Math):

*"Open Calculator, calculate 245.12 * 3.14159, and tell me the result."*

1. 📁 The Safe File Organizer (Desktop Triage):

*"Inspect my Desktop, find all screenshot files, and organize them into a clean Screenshots folder."*

---

Option D: Developer Git Clone

# Linux / macOS:

git clone https://github.com/AIYantra/extra.git ~/.extra/app cd ~/.extra/app && ./install.sh

Windows:

git clone https://github.com/AIYantra/extra.git "$HOME\.extra\app" cd "$HOME\.extra\app" ; .\install.ps1

---

Connecting to Any MCP-Compatible AI

Extra works out of the box with any agent supporting the Model Context Protocol (MCP). If you use Cursor, Windsurf, or custom agents, add this snippet to your MCP config:

{

"mcpServers": { "extra": { "command": "npx", "args": ["-y", "@yantraos/extra-desktop"] } } }

Or using native Python:

{

"mcpServers": { "extra": { "command": "python", "args": ["-m", "extra.mcp.server"] } } }

---

How Does Extra Work Under the Hood?

Extra operates via a sovereign Dual-Plane Architecture that decouples visual perception from hardware actuation. For perception, Extra combines sub-3ms GPU frame capture (DirectX DXGI, Metal, Spectacle) with OS accessibility hierarchy inspection (COM UI Automation, AT-SPI2, Quartz). For actuation, Extra dispatches lossless kernel and Win32 hardware events with zero coordinate drift, guaranteeing deterministic control across all resolutions and display scaling factors.

Extra is engineered from the ground up for speed, reliability, and token efficiency:

1. 👁️ Ultra-Fast Screen Capture (< 3ms): Uses native DirectX Desktop Duplication (DXGI) to take crystal-clear desktop frames in under 3 milliseconds—without lagging your PC or blurring text.
2. 🎯 Pixel-Perfect Clicking: Rather than guessing coordinates from fuzzy screenshots, Extra queries the native Windows accessibility tree (UI Automation) to click the exact button, menu, or text field with 100% mathematical accuracy.
3. ⚡ Instant Typing: Types 500 characters in under 5 milliseconds via native Win32 Unicode injection—with zero dropped letters and full support for emojis and international languages.
4. 🛑 Infinite Loop Stall Protection: If an app freezes or a click produces no visual result, Extra immediately catches it and stops safely instead of burning your tokens in an endless loop.
5. 🔒 100% Local & Private: Extra runs completely on your machine. Zero screenshots, keystrokes, or telemetry are ever sent to any cloud server.

---

📊 Performance Comparison

---

🛠️ Included Tools (MCP Suite — 20 Native Tools)

When connected to Extra, your AI assistant receives full sovereign desktop control across 20 native tools:

---

🏛️ Repository Structure

extra/

├── assets/ # Brand logos and banners ├── bin/