nano-use Overview

nano-use is a local macOS command-line tool for screenshots, pointer, keyboard, and scroll actions—designed to be called by an external agent.

What nano-use is

nano-use is a local macOS command-line tool that gives you screenshot, pointer, keyboard, and scrolling primitives. An external agent can call these primitives to interact with the desktop, but the tool itself doesn't plan, pick targets, or decide what to do next—it just executes exactly what it's told.

Command surface

There are exactly eight commands: screenshot, click, right_click, double_click, drag, type, keypress, and scroll. Every command runs locally on your Mac. This revision has no server component and no MCP wrapper.

Operating boundary

Screenshot capture requires Screen Recording permission. Pointer and keyboard events require Accessibility permission. The commands that take coordinates—click, right_click, double_click, drag, and scroll—validate points against one axis-aligned bounding rectangle that encloses all active display rectangles. This means points in gaps between displays can still pass validation. type and keypress don't involve coordinates, so there's nothing to validate there.

Where to go next

Head to Quick Start to build the binary, then Commands for the exact positional arguments each command expects. If something isn't working, Permissions and Troubleshooting covers the most common issues.