Quick start
- Install the Zo desktop app
- Log in (your device registers automatically)
- Go to Settings > Advanced > Devices
- Add capabilities (Browser, Shell, etc.)
Capabilities
Browser Control
Browser Control
Lets Zo use Chrome on your computer to browse the web, click elements, fill forms, and take screenshots. Powered by
agent-browser, a bundled CLI that drives Chrome via the DevTools Protocol. Requires Google Chrome or another Chromium-based browser installed on your machine.Because this uses your local browser, Zo can interact with sites you’re already logged into.iMessage (macOS only)
iMessage (macOS only)
Lets Zo send and read iMessages on your computer. Powered by
imsg, a bundled CLI that reads the macOS Messages database directly.Requires granting Full Disk Access to the Zo desktop app in System Settings > Privacy & Security.Shell Commands
Shell Commands
Lets Zo run shell commands on your computer. Sandboxed by default (see below).
File Access
File Access
Lets Zo read and manage files on your computer: list, read, copy, move, and create directories. Sandboxed by default (see below).
Custom
Custom
Create your own capabilities with a name, permission patterns, and a prompt that tells Zo how to use it. Useful for granting access to specific CLI tools or workflows on your machine.Permissions use glob patterns to control which commands are allowed. For example,
Bash(docker *) allows any command starting with docker, and !Bash(docker rm *) denies container removal. Deny rules are checked first, and anything not explicitly allowed is blocked by default.