# Try Action on your Mac

Install Action, grant permissions, and take your first screenshot.

## Prerequisites

macOS on Apple Silicon, with Bun installed. No source build needed.

Install Bun: https://bun.sh/docs/installation

## 1. Install and launch

```sh
bun add -g @arach/lattices
lats action install --launch
```

Expected result: Action.app opens from Applications. The CLI is available as lats.

## 2. Allow access

```sh
lats action call permissions.request
lats action call permissions.snapshot
```

Expected result: Approve Accessibility and Screen Recording in macOS, then run the second command. Both permissions should report granted.

## 3. Take a screenshot

```sh
lats action call capture.screenshotScreen \
  '{"output":"/tmp/action-first.png"}'
open /tmp/action-first.png
```

Expected result: The reply reports status: screenshot. Your main display capture opens in Preview. This captures your screen, not a private workspace.

## Troubleshooting

Agent not reachable? Run lats action launch, then retry. Permission denied? Enable Action in System Settings → Privacy & Security, quit and reopen Action, then check permissions again.

## Connect an agent

The app download includes native capture. Agent-driven browser work and the virtual workspaces in the demo also need the matching MCP runtime and host preflight.

MCP setup: https://lattices.dev/action/agent-setup.md

## Linux

Linux uses a remote lattices-host connection, not the macOS app. Available actions depend on the host; macOS overlays and Accessibility are not available there.

Remote setup: https://lattices.dev/action/remote-engine.md
