Developer Tools

Agent Desktop

agent-desktop-pp-cli

Printing Press bridge for the Rust agent-desktop desktop automation CLI.

Printed by @lahfir (Lahfir)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install agent-desktop

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-agent-desktop --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-agent-desktop skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-agent-desktop. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

View source on GitHub →

agent-desktop-pp-cli makes the Rust agent-desktop desktop automation CLI visible in the Printing Press library.

This package does not copy or reimplement the Rust CLI. It delegates to the real agent-desktop binary and installs that binary through the existing remote npm package, which downloads verified GitHub release assets for the selected package version.

agent-desktop is a native desktop automation CLI for AI agents. It reads OS accessibility trees, returns structured JSON, assigns snapshot-scoped refs like @e1, and lets agents perform semantic actions such as clicking, typing, scrolling, waiting, managing windows, reading notifications, using the clipboard, and taking screenshots.

Commands

agent-desktop-pp-cli info
agent-desktop-pp-cli install --dry-run
agent-desktop-pp-cli doctor --json

The run command passes arguments to the real agent-desktop executable and preserves its exit code.

Real agent-desktop workflow

agent-desktop permissions
agent-desktop snapshot --app Finder -i --compact
agent-desktop click @e5 --snapshot <snapshot_id>
agent-desktop wait --element @e5 --snapshot <snapshot_id> --predicate actionable --timeout 5000
agent-desktop snapshot --app Finder -i --compact

The real CLI exposes 54 commands across observation, interaction, scroll, keyboard, mouse, app/window, notifications, clipboard, wait, system, and batch categories. Use agent-desktop skills get desktop --full for the complete command guide that ships with the installed binary.