Mano skill

Install

brew install Mininglamp-AI/tap/mano-cua

This is third-party code. Review the repository files before installing.

What it does

The mano-cua tool performs GUI tasks where an app has no API or CLI. At each step it takes a screenshot, sends it with the task to a model and executes the returned action: click, type, hotkey, scroll, drag or app launch. In cloud mode the server picks between the lightweight Mano model and Claude CUA. In local mode the Mano-P model runs on-device via MLX and no data leaves the machine. The skill teaches the agent to call this tool.

Who it is for. For people who need to automate desktop apps without an API, mainly on macOS.

Example request

Open Notes and create a new note titled Meeting Summary

Limitations

In cloud mode screenshots go to the developer's server and complex steps are handled by a Claude model, so access from Russia without a VPN is not guaranteed. Local mode works only on macOS with Apple Silicon. Screen recording and accessibility permissions are required. One task runs at a time, only the primary display is used, and you must not touch the mouse or keyboard during a run. Windows and Linux support is incomplete.

How to disable. Stop a task with mano-cua stop, remove the tool with brew uninstall mano-cua and delete the skill folder from your agent's skills directory. Revoke the permissions in macOS privacy settings.

Security check

• Controls the mouse and keyboard and opens and closes apps
• In cloud mode sends screenshots to an external server

README in short

The README explains the loop: screenshot, server-side model selection, action execution. Install via Homebrew on macOS and Linux or a release archive on Windows. It covers run and stop with --url, --app, --minimize and --max-steps, local mode setup, required permissions and safety rules. MIT-0 licensed.

SKILL.md

---
name: mano-cua
description: Computer use for GUI automation tasks via VLA models. Use when the user describes a task in natural language that requires visual screen interaction and no API or CLI exists for the target app.
homepage: https://github.com/Mininglamp-AI/mano-skill
metadata: {"openclaw": {"emoji": "🖥️", "install": [{"id": "brew", "kind": "brew", "formula":"Mininglamp-AI/tap/mano-cua", "bins":["mano-cua"],"label": "Install mano-cua (brew)"}]}}
---

# mano-cua

Desktop GUI automation for tasks via VLA models. Use when the user describes a task in natural language that requires visual screen interaction and no API or CLI exists for the target app. Supports fully on-device local mode and cloud mode.

## Requirements

- A system with a **graphical desktop** (macOS / Windows / Linux)
- `mano-cua` binary installed (v1.1.0+ recommended for full feature support)

### Installation

**macOS / Linux (Homebrew):**

```bash
brew install Mininglamp-AI/tap/mano-cua

# Update to latest version
brew upgrade Mininglamp-AI/tap/mano-cua
```

**Windows:**

Download the latest `mano-cua-windows.zip` from [GitHub Releases](https://github.com/Mininglamp-AI/mano-skill/releases), extract it, and add the folder to your `PATH`.

## Usage

```bash
# Run a task
mano-cua run "your task description"

# Run with options (minimize UI panel and set max steps)
mano-cua run "task" --minimize --max-steps 10

# Open a URL in the browser before starting the task
mano-cua run "task" --url "https://example.com"

# Open an app before starting the task
mano-cua run "task" --app "Notes"

# Run in local mode (on-device inference, macOS Apple Silicon only)
mano-cua run "task" --local

# Stop the current running task
mano-cua stop
```

Related