Quick Start

Build nano-use locally, inspect its help, and make screenshot observation the first bounded step.

Prerequisites

Use a Mac with a Rust toolchain. Grant permissions deliberately: Screen Recording is for screenshots, while Accessibility is for pointer and keyboard actions.

Build and inspect

From the fixed source tree, build the release binary and inspect the generated help before allowing an agent to call it.

cargo build --release
target/release/nano-use --help

The binary is written to target/release/nano-use. Copying it onto PATH is optional and does not change the command contract.

Start with observation

nano-use screenshot writes a base64-encoded PNG followed by a newline to standard output. Treat the screenshot as observation only. Confirm a concrete target before issuing any command that changes desktop state.

Continue safely

Read Agent Integration before connecting model output to process arguments. If the screenshot is empty or input events have no visible effect, use Permissions and Troubleshooting.