nano-use Overview

What nano-use is

nano-use is a local macOS command line tool that exposes screenshot, pointer, keyboard, and scrolling primitives. An external agent can call those primitives, but the tool itself does not plan, choose targets, or decide what to do next.

Command surface

The fixed source defines exactly eight commands: screenshot, click, right_click, double_click, drag, type, keypress, and scroll. Each command runs on the local Mac; there is no server or MCP wrapper in this revision.

Operating boundary

Screenshot capture needs Screen Recording permission. Pointer and keyboard events need Accessibility permission. The coordinate-bearing commands are click, right_click, double_click, drag, and scroll. Before posting those pointer, drag, or scroll events, the fixed source checks coordinates against one axis-aligned bounding rectangle enclosing all active display rectangles. It does not test membership in each display, so points in gaps between displays can pass validation. The type and keypress commands have no coordinates to validate.

Where to go next

Use Quick Start to build the binary, Commands for the exact positional arguments, and Permissions and Troubleshooting when observation or input does not work.