Naturo — Desktop Automation Engine (Eyes + Hands for AI Agents)

See, click, type, capture. Desktop automation core only.

Why naturo? It is the only open-source Windows automation engine with commercial-RPA-grade multi-framework recognition — UIA + MSAA/IA2 + Java Access Bridge + Electron/CDP + vision fusion. UIA-only rivals (UFO², Windows-MCP, Terminator) are blind to Electron and Java app content. See the reproducible proof: Recognition coverage benchmark → docs/RECOGNITION.md.

New here? Get Claude to open, type into, and save a Notepad file in under five minutes: 5-minute quickstart → docs/QUICKSTART.md.

What You Get

🖥️ Screen Capture — Screenshot any window or monitor
🌳 UI Tree Inspection — Walk the accessibility tree (UIA / MSAA / IAccessible2 / Java Access Bridge)
🔍 Element Finding — CSS-like selectors + fuzzy search for UI elements
🖱️ Click & Type — Hardware-level input simulation
⌨️ Key Combos — Send any keystroke or shortcut
🎮 Hardware Keyboard — Scan-code input bypasses virtual-key detection (games, anti-cheat)
📸 Annotated Screenshots — AI-ready screenshots with numbered bounding boxes
📋 Menu Traversal — Extract app menu structures with shortcuts
🪟 Window Management — Focus, close, minimize, maximize, move, resize windows
📦 App Control — Launch, quit, switch, hide/unhide applications
💬 Dialog Handling — Detect and interact with system dialogs (message boxes, file pickers)
📌 Taskbar & Tray — List and click taskbar items and system tray icons
🖥️ Multi-Monitor — Enumerate monitors, capture specific screens, DPI-aware coordinates
🗂️ Virtual Desktops — List, switch, create, close desktops and move windows between them
🍎 macOS Support — Coming soon (native implementation in development)
🎬 Recording & Playback — Record user actions, replay them, export to Python/Bash scripts
🏷️ Selector Management — Save, share, and reuse UI element selectors across sessions
🌐 Browser Automation — Full Chrome DevTools Protocol support: navigate, click, type, screenshot, wait, intercept network, stealth mode
🔬 Cascade Recognition — UIA + CDP + AI Vision multi-source fusion for Electron/CEF apps where single-source fails
👁️ Visual Regression Testing — Compare screenshots across runs, generate HTML reports, detect unintended UI changes
🤖 AI-Ready — JSON output, agent-friendly CLI, MCP server

Platform Support

Platform	Status	Notes
Windows 10/11	✅ Full support	Primary platform. All features available.
Windows 7 SP1+	⚠️ Best-effort	Basic features only, no UIAutomation v3.
macOS 13+	🚧 Coming soon	Native support is under active development.
Linux	🚧 Coming soon	Backend is a placeholder. Not usable yet.
Python	3.9+	Required for all platforms.

Why Windows 10+? UIAutomation v2/v3 APIs (caching, virtualized controls) require Windows 8+. Windows 7 has been out of support since January 2020. Most enterprise customers have migrated to Windows 10/11.

Install

pip install naturo

MCP Server Setup

Naturo includes a built-in MCP server with 60+ tools for AI agent integration.

Quick install (one line)

After pip install naturo, connect naturo to your agent with a single copy-paste command:

Claude Code

claude mcp add naturo -- naturo mcp start

VS Code (GitHub Copilot / MCP)

code --add-mcp '{"name":"naturo","command":"naturo","args":["mcp","start"]}'

Cursor — add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{ "mcpServers": { "naturo": { "command": "naturo", "args": ["mcp", "start"] } } }

Windsurf — add to ~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "naturo": { "command": "naturo", "args": ["mcp", "start"] } } }

naturo must be on your PATH — it is after pip install naturo. Restart the client after editing a JSON config so it picks up the new server.

Claude Desktop (manual config)

Add to your Claude configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "naturo": {
      "command": "naturo",
      "args": ["mcp", "start"]
    }
  }
}

Config file location:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Other AI Agents (SSE / HTTP)

For agents that connect over HTTP instead of stdio:

# SSE transport (Server-Sent Events)
naturo mcp start --transport sse --port 3100

# Streamable HTTP transport
naturo mcp start --transport streamable-http --port 3100

Verify Setup

# List all 60+ MCP tools
naturo mcp tools

# Install MCP dependencies if needed
naturo mcp install

Quick Start

# Check version
naturo --version

# Capture a screenshot
naturo capture --path screen.png

# List open windows
naturo list windows

# Inspect UI tree
naturo see --window "Notepad" --depth 5

# Click an element
naturo click "Button:Save"

# Type text
naturo type "Hello, World!"

# Type with hardware scan codes (bypass anti-cheat detection)
naturo type "Hello" --input-mode hardware

# Press key combo
naturo press ctrl+s

# Find element — the universal locator auto-detects the strategy from the query
naturo find "Edit:filename"                # UIA tree search (name / role:name)
naturo find button.png                     # image template match (.png/.jpg/…)
naturo find 'app://notepad.exe/Edit'       # resolve a selector path
naturo find @notepad/save-btn              # resolve a saved selector (@app/name)

# App management
naturo app launch "notepad"
naturo app focus "notepad"
naturo app quit "chrome" --force
naturo app minimize "notepad"
naturo app restore "notepad"
naturo app inspect "notepad"             # Probe frameworks (UIA, CDP, MSAA...)
naturo app relaunch "notepad"

# Dialog handling
naturo dialog detect                       # Detect active dialogs
naturo dialog accept                       # Click OK/Yes
naturo dialog dismiss                      # Click Cancel/No
naturo dialog type "hello.txt" --accept    # Type filename then OK

# Taskbar & tray
naturo taskbar list                        # List taskbar items
naturo taskbar click "Chrome"              # Click taskbar button
naturo tray list                           # List tray icons
naturo tray click "Volume"                 # Left-click tray icon
naturo tray click "Wi-Fi" --right          # Right-click for menu

# Virtual desktops (Windows 10/11)
naturo desktop list                        # List virtual desktops
naturo desktop switch 1                    # Switch to desktop 1
naturo desktop create --name "Work"        # Create named desktop
naturo desktop close                       # Close current desktop
naturo desktop move-window 1 --app "Notepad"  # Move window to desktop 1

# Type Windows paths literally (--raw disables escape interpretation)
naturo type "C:\Users\test\report.txt" --raw --app notepad

# Paste text via clipboard (fast for large content)
naturo type "large content" --paste        # Set clipboard → Ctrl+V → restore
naturo type --paste --file data.txt        # Read file → paste

# Read element values
naturo get e47                             # Read text/value by element ref
naturo get --aid txtSearch                 # Read by AutomationId
naturo get --role Edit --name Search       # Read by role + name
naturo get --role Button --app notepad --all -j  # All buttons (JSON)

# Write element values
naturo set e47 "hello world"               # Set text field value
naturo set --aid txtSearch "query"          # Set by AutomationId
naturo set e12 --toggle                    # Toggle a checkbox
naturo set e8 --select                     # Select a list/radio item
naturo set e5 --expand                     # Expand a combo box

# Highlight UI elements
naturo highlight --app notepad             # Show actionable elements
naturo highlight --app notepad --all       # Show all elements
naturo highlight e11 --app notepad         # Highlight specific ref
naturo highlight --app notepad -A out.png  # Save annotated screenshot

Cascade Recognition

Most desktop automation tools rely on a single accessibility API (UIA) — when it fails (Electron apps, custom-rendered UI), you're stuck. Naturo cascades through multiple recognition sources automatically:

UIA → CDP → AI Vision
 ↓      ↓       ↓
Win32  Chrome   Claude/GPT
native DevTools  screenshot

# Progressive multi-source recognition
naturo see --app feishu --cascade --fill-gaps --stats

# Result: UIA finds 700+ elements, AI Vision adds 130+ that UIA missed
#   uia      705 elements    6s   [ok]
#   cdp        0 elements   15s   [skipped]
#   vision   133 elements   72s   [ok]

# Click an AI-discovered element by ref
naturo click e805 --app feishu    # "视频会议" (Video Meeting) found by AI Vision

How it works:

UIA/MSAA finds native Win32/WPF/UWP controls (fastest, most accurate)
CDP reaches into Electron/Chrome web content via DevTools Protocol
AI Vision screenshots the window and asks Claude/GPT to enumerate every visible element — catches anything the other sources miss
IoU dedup prevents duplicates: if UIA already found an element, AI Vision skips it
Tree merge attaches AI-discovered elements to the correct UIA parent container

Requires ANTHROPIC_API_KEY or OPENAI_API_KEY for AI Vision. Set NATURO_AI_MODEL to choose the model (default: claude-sonnet-4-20250514).

CLI Commands

See (observe the desktop)

Command	Description	Since
`capture`	Screenshot screen/window	0.1.0
`see`	Inspect UI element tree	0.1.0
`find`	Search UI elements (fuzzy match)	0.1.0
`get`	Read element properties (text, value, state)	0.2.1
`highlight`	Visual overlay showing all actionable elements	0.3.0
`list windows`	List open windows	0.1.0
`list apps`	List running applications	0.1.0
`list screens`	List monitors and resolutions	0.1.0
`diff`	Compare two UI snapshots	0.1.1
`menu-inspect`	List app menu structure with shortcuts	0.1.0

Act (interact with the desktop)

Command	Description	Since
`click`	Click element/coordinates (`--paste`, `--copy`, `--cut` modifiers)	0.1.0
`type`	Type text (supports `--paste` for clipboard)	0.1.0
`set`	Set element value/state (toggle, select, expand)	0.3.0
`press`	Press key combination (e.g., `ctrl+s`)	0.1.0
`scroll`	Scroll mouse wheel	0.1.0
`drag`	Drag from/to coordinates	0.1.0
`move`	Move mouse cursor	0.1.0
`wait`	Wait for element/window to appear	0.1.0

App management

Command	Description	Since
`app launch`	Launch application by name or path	0.1.0
`app quit`	Quit application (supports `--force`)	0.1.0
`app focus`	Focus an application window (alias: `app switch`)	0.1.0
`app close`	Close an application window (graceful or forced)	0.1.0
`app minimize`	Minimize an application window (alias: `app hide`)	0.1.0
`app maximize`	Maximize an application window	0.1.0
`app restore`	Restore a minimized/maximized window (alias: `app unhide`)	0.1.0
`app move`	Move and/or resize an application window	0.1.0
`app list`	List running applications with visible windows	0.1.0
`app windows`	List open windows (filter by app/PID)	0.1.0
`app find`	Find application by name or PID	0.1.0
`app inspect`	Probe app frameworks (UIA, CDP, MSAA...)	0.3.0
`app relaunch`	Quit and relaunch an application	0.3.0

System

Command	Description	Since
`clipboard get`	Read clipboard text content	0.3.1
`clipboard set`	Write text to clipboard	0.3.1
`clipboard clear`	Clear clipboard contents	0.3.1
`clipboard info`	Show clipboard format and size	0.3.1
`dialog detect`	Detect active system dialogs	0.1.0
`dialog accept`	Accept (OK/Yes) a dialog	0.1.0
`dialog dismiss`	Dismiss (Cancel/No) a dialog	0.1.0
`dialog click-button`	Click specific dialog button	0.1.0
`dialog type`	Type in dialog input field	0.1.0
`taskbar list`	List taskbar items	0.1.0
`taskbar click`	Click taskbar item	0.1.0
`tray list`	List system tray icons	0.1.0
`tray click`	Click tray icon (left/right/double)	0.1.0
`desktop list`	List virtual desktops	0.1.0
`desktop switch`	Switch to a virtual desktop	0.1.0
`desktop create`	Create a new virtual desktop	0.1.0
`desktop close`	Close a virtual desktop	0.1.0
`desktop move-window`	Move window to another desktop	0.1.0

Browser Automation

Command	Description	Since
`browser navigate`	Navigate to a URL	0.3.2
`browser find`	Find elements on the page (CSS/XPath/text)	0.3.2
`browser click`	Click an element	0.3.2
`browser type`	Type text into an element	0.3.2
`browser screenshot`	Take a page screenshot	0.3.2
`browser text`	Get element text content	0.3.2
`browser html`	Get element HTML content	0.3.2
`browser attr`	Get an attribute value from an element	0.3.2
`browser eval`	Evaluate JavaScript expression	0.3.2
`browser hover`	Hover over an element	0.3.2
`browser scroll`	Scroll the page	0.3.2
`browser tabs`	List open browser tabs	0.3.2
`browser tab`	Switch to a specific tab	0.3.2
`browser close`	Close the CDP connection	0.3.2
`browser url`	Get the current page URL	0.3.2
`browser title`	Get the current page title	0.3.2
`browser requests`	List captured network requests	0.3.2
`browser intercept`	Add a request interception rule	0.3.2
`browser wait`	Wait for element state	0.3.2
`browser wait-navigation`	Wait for navigation to complete	0.3.2
`browser wait-network-idle`	Wait until network is idle	0.3.2
`browser wait-url`	Wait until URL matches a pattern	0.3.2
`browser wait-function`	Wait until JS expression is truthy	0.3.2
`browser stealth`	Apply anti-detection patches	0.3.2
`browser stealth-flags`	Print Chrome flags for anti-detection	0.3.2
`browser launch`	Launch Chrome with remote debugging enabled	0.3.2
`browser profiles`	List available Chrome profiles	0.3.2
`browser select`	Select an option from a `<select>` dropdown	0.3.2
`browser download`	Configure file downloads and wait for completion	0.3.2
`browser frames`	List all frames (main frame and iframes) on the page	0.3.2
`browser frame-find`	Find elements inside a specific iframe	0.3.2
`browser frame-eval`	Evaluate JavaScript inside a specific iframe	0.3.2
`browser stealth-check`	Verify stealth patches are working	0.3.2
`browser captcha-detect`	Detect captchas on the page	0.3.2
`browser captcha-solve`	Solve a captcha on the page	0.3.2

Visual Regression Testing

Command	Description	Since
`visual baseline`	Save a screenshot as a visual baseline	0.3.2
`visual compare`	Compare a screenshot against its baseline	0.3.2
`visual diff`	Compare any two images directly	0.3.2
`visual list`	List all saved baselines	0.3.2
`visual delete`	Delete a saved baseline	0.3.2
`visual report`	Run regression tests and generate HTML report	0.3.2
`visual suite`	Run a visual regression test suite from a JSON definition	0.3.2
`visual update`	Update an existing baseline with a new screenshot	0.3.2
`visual update-all`	Update all baselines from a directory of screenshots	0.3.2

Tools

Command	Description	Since
`snapshot list`	List stored snapshots	0.1.0
`snapshot sessions`	List all snapshot sessions	0.1.0
`snapshot clean`	Remove old snapshots	0.1.0
`mcp start`	Start MCP server	0.1.0
`mcp install`	Install MCP server configuration	0.3.0
`mcp tools`	List available MCP tools	0.3.0
`record start`	Start recording user actions	0.3.2
`record stop`	Stop recording and save	0.3.2
`record play`	Replay a saved recording	0.3.2
`record list`	List saved recordings	0.3.2
`record show`	Show recording steps	0.3.2
`record delete`	Delete a recording	0.3.2
`record export`	Export recording to Python/Bash/JSON	0.3.2
`selector save`	Save a UI selector with a friendly name	0.3.2
`selector load`	Load a saved selector by name and resolve it	0.3.2
`selector list`	List saved/built-in selectors	0.3.2
`selector show`	Show all selectors for an app (user + built-in)	0.3.2
`selector delete`	Delete a saved selector	0.3.2
`selector clear`	Delete all selectors for an app	0.3.2
`selector export`	Export selectors to JSON	0.3.2
`selector import`	Import selectors from JSON	0.3.2
`selector test`	Validate a selector against the parser	0.3.2
`config`	View/set naturo configuration	0.3.0
`doctor`	Environment self-check (session, deps, providers, DPI, version)	0.3.4
`excel open`	Open Excel workbook (Windows only)	0.1.1
`excel read`	Read cells from worksheet	0.1.1
`excel write`	Write values to cells	0.1.1
`excel list-sheets`	List worksheets in workbook	0.1.1
`excel run-macro`	Execute VBA macro	0.1.1
`excel info`	Show workbook metadata	0.1.1

Deprecated: window * commands still work but print a deprecation warning. Use app * equivalents instead. hotkey is deprecated in favor of press.

Snapshot System

Every see and capture call automatically persists a snapshot — a directory under ~/.naturo/snapshots/ containing the screenshot and full UI element map.

# List all snapshots
naturo snapshot list

# Remove snapshots older than 7 days
naturo snapshot clean --days 7

# Remove all snapshots
naturo snapshot clean --all --yes

Snapshots expire after 10 minutes when queried via get_most_recent_snapshot, mirroring Peekaboo's validity window.

Recording & Playback

Record user actions and replay them — the fastest way to create automation scripts.

# Start recording — all subsequent naturo commands are captured
naturo record start "Login flow"

# ... perform actions ...
naturo click 500 300
naturo type "username"
naturo press tab
naturo type "password"
naturo press enter

# Stop and save
naturo record stop

# List saved recordings
naturo record list
# ID                        Name                           Steps  Created
# rec_20260401_120000       Login flow                         5  2026-04-01T12:00

# Replay at 2x speed
naturo record play rec_20260401_120000 --speed 2.0

# Preview without executing
naturo record play rec_20260401_120000 --dry-run

# Export to a standalone Python script
naturo record export rec_20260401_120000 --format python -o login.py

# Export to Bash
naturo record export rec_20260401_120000 --format bash -o login.sh

# Show step details
naturo record show rec_20260401_120000

Recordings are stored in ~/.naturo/recordings/ as JSON files. Export to Python or Bash generates standalone scripts with proper timing between steps.

Selector Management

Save, reuse, and share UI element selectors — no more re-discovering selectors for common apps.

# Save a selector with a friendly name
naturo selector save notepad save-btn 'app://notepad.exe/Button[@name="Save"]'
naturo selector save chrome address-bar '//Edit[@name="Address and search bar"]' \
  -d "Chrome address bar"

# List all saved selectors
naturo selector list
#   notepad (1 selectors)
#   ──────────────────────────────────────────────────
#     @notepad/save-btn
#       app://notepad.exe/Button[@name="Save"]

# List built-in templates (shipped with naturo)
naturo selector list --builtin

# Use a saved selector (@ prefix in click/type/find commands)
naturo click --selector @notepad/save-btn

# Test that a selector parses correctly
naturo selector test notepad save-btn

# Export for sharing with your team
naturo selector export notepad -o notepad-selectors.json

# Import selectors from a teammate
naturo selector import team-selectors.json

# Clean up
naturo selector delete notepad save-btn
naturo selector clear notepad  # delete all selectors for an app

Selectors are stored in ~/.naturo/selectors/<app>.json. Built-in templates live in naturo/selectors_builtin/ and are read-only.

Browser Automation

Automate Chrome, Edge, and Chromium-based browsers via the Chrome DevTools Protocol (CDP).

# Launch Chrome with debugging enabled (using naturo)
naturo browser launch
# Or manually: chrome --remote-debugging-port=9222

# Navigate to a page
naturo browser navigate https://example.com

# Find elements using CSS selectors, XPath, or text
naturo browser find "#search-input"
naturo browser find "//button[@type='submit']"

# Click and type
naturo browser click "button.submit"
naturo browser type "#search" "hello world"

# Take a screenshot
naturo browser screenshot --path page.png

# Read page content
naturo browser text "#main-content"
naturo browser html "#article"
naturo browser title
naturo browser url

# Tab management
naturo browser tabs                           # List all tabs
naturo browser tab <tab-id>                   # Switch to a tab

# Wait for conditions
naturo browser wait "#results" --state visible
naturo browser wait-navigation                # Wait for page load
naturo browser wait-network-idle              # Wait for network to settle
naturo browser wait-url "*/dashboard*"        # Wait for URL pattern

# Execute JavaScript
naturo browser eval "document.title"

# Network interception
naturo browser intercept "*.png" --action block   # Block image requests
naturo browser requests                            # List captured requests

# Anti-detection (stealth mode)
naturo browser stealth-flags                  # Print recommended Chrome flags
naturo browser stealth                        # Apply runtime patches

# Captcha handling
naturo browser captcha-detect                 # Detect captchas on page
naturo browser captcha-solve                  # Attempt to solve

# Chrome profiles
naturo browser profiles                       # List available profiles
naturo browser launch --profile "Work"        # Launch with a specific profile

# Iframe support
naturo browser frames                         # List all frames on page
naturo browser frame-find 0 "#login-form"     # Find element inside iframe
naturo browser frame-eval 0 "document.title"  # Run JS inside iframe

# File downloads
naturo browser download --dir ./downloads     # Set download directory
naturo browser download --wait 30             # Wait up to 30s for download

# Select dropdowns
naturo browser select "#country" "United States"  # Select by visible text

All browser commands support --port and --host for connecting to remote Chrome instances.

Visual Regression Testing

Compare screenshots across runs to detect unintended UI changes.

# Save a baseline screenshot
naturo visual baseline login_screen --from screenshot.png

# Compare against baseline
naturo visual compare login_screen --current screenshot2.png
# Reports pixel differences with configurable threshold

# Compare any two images directly (without baseline)
naturo visual diff before.png after.png

# List all baselines
naturo visual list

# Generate an HTML report
naturo visual report --name "Sprint 42" --output report.html

# Update a baseline with new screenshot
naturo visual update login_screen --from new_screenshot.png

# Run a test suite from a JSON definition
naturo visual suite test_suite.json --output report.html

# Clean up
naturo visual delete login_screen

Baselines are stored in ~/.naturo/visual/baselines/. Reports are generated in ~/.naturo/visual/reports/.

Architecture

┌─────────────┐
│  AI Agent    │  Python SDK / MCP Server
├─────────────┤
│  CLI (click) │  naturo CLI
├─────────────┤
│  Snapshot    │  naturo/snapshot.py + naturo/models/snapshot.py
├─────────────┤
│  Python      │  ctypes bridge
├─────────────┤
│  C API       │  exports.h
├─────────────┤
│  C++ Core    │  UIA, MSAA, IA2, JAB, Win32, DirectX
└─────────────┘

See docs/ARCHITECTURE.md for details.

Comparison

Feature	naturo	PyAutoGUI	pywinauto	AutoIt	WinAppDriver
MCP Server	✅ Built-in	❌	❌	❌	❌
AI Agent Ready	⚠️ JSON output, agent CLI (`-j` envelope being standardized)	❌	❌	❌	❌
Browser Automation	✅ CDP (Chrome/Edge)	❌	❌	❌	❌
UI Frameworks	UIA + MSAA + IA2 + JAB + CDP + AI Vision	None (image only)	UIA, Win32	Win32 messages	UIA only
Cascade Recognition	✅ Multi-source fusion with auto-dedup	❌	❌	❌	❌
Auto-Detection	✅ Picks best framework per app	N/A	Manual backend choice	N/A	N/A
Element Tree	✅ Full hierarchy	❌	✅	❌	✅
Post-Action Verify	✅ Confirms actions took effect	❌	❌	❌	❌
Hardware Keyboard	✅ Scan codes (anti-cheat safe)	❌	❌	✅	❌
Image Matching	Via AI vision	✅ Built-in	❌	✅	❌
Screen Capture	✅ DirectX / GDI	✅	❌	✅	❌
Cross-Platform	Windows + macOS	Win / Mac / Linux	Windows (+ Linux partial)	Windows only	Windows only
Language	Python + C++ core	Python	Python	Custom script	C# / WebDriver
Maintained	✅ Active	✅ Active	⚠️ Slow	⚠️ Slow	❌ Deprecated

vs Peekaboo (macOS)

Naturo aims to provide cross-platform desktop automation. On macOS, native support is coming soon.

	Peekaboo (macOS)	Naturo (Windows)	Naturo (macOS - planned)
UI Framework	Accessibility API	UIA + MSAA + IA2 + JAB	Accessibility API
Screen Capture	ScreenCaptureKit	DirectX / GDI	ScreenCaptureKit
Input	CGEvent	SendInput + Phys32 scan codes	CGEvent
Language	Swift	C++	C++ / Python bridge
Status	Available	Available	Coming soon

Name		Name	Last commit message	Last commit date
Latest commit History 629 Commits
.github		.github
.work/reviews		.work/reviews
agents		agents
benchmarks		benchmarks
core		core
docs		docs
examples		examples
naturo		naturo
npm		npm
openclaw-skill		openclaw-skill
packaging/mcpb		packaging/mcpb
scripts		scripts
tests		tests
work/reviews		work/reviews
.gitignore		.gitignore
.mailmap		.mailmap
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
NEEDS-ACE.md		NEEDS-ACE.md
README.md		README.md
SECURITY.md		SECURITY.md
TEST_PLAN.md		TEST_PLAN.md
bugs.md		bugs.md
capture.png		capture.png
pyproject.toml		pyproject.toml
test_readme_platforms.py		test_readme_platforms.py

Navigation Menu

Repository files navigation

Naturo — Desktop Automation Engine (Eyes + Hands for AI Agents)

What You Get

Platform Support

Install

MCP Server Setup

Quick install (one line)

Claude Desktop (manual config)

Other AI Agents (SSE / HTTP)

Verify Setup

Quick Start

Cascade Recognition

CLI Commands

See (observe the desktop)

Act (interact with the desktop)

App management

System

Browser Automation

Visual Regression Testing

Tools

Snapshot System

Recording & Playback

Selector Management

Browser Automation

Visual Regression Testing

Architecture

Comparison

vs Peekaboo (macOS)

Contributing

License

About

Releases

Packages

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Naturo — Desktop Automation Engine (Eyes + Hands for AI Agents)

What You Get

Platform Support

Install

MCP Server Setup

Quick install (one line)

Claude Desktop (manual config)

Other AI Agents (SSE / HTTP)

Verify Setup

Quick Start

Cascade Recognition

CLI Commands

See (observe the desktop)

Act (interact with the desktop)

App management

System

Browser Automation

Visual Regression Testing

Tools

Snapshot System

Recording & Playback

Selector Management

Browser Automation

Visual Regression Testing

Architecture

Comparison

vs Peekaboo (macOS)

Contributing

License

About

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages