# AGENTS.md - Apple iCloud CLI

You are being asked to install or use the Apple iCloud CLI from the Printing Press library.

## What it is

icloud-pp-cli is an agent-native command line tool for Apple iCloud. Query iCloud data stored locally on macOS — Photos library storage analysis, with Contacts and more coming. All reads hit local SQLite databases directly; no network calls or iCloud API token required.
It is a single Go binary that ships with an agent skill, and it installs with one command.

## Install

Recommended (installs the binary and the agent skill):

    npx -y @mvanhorn/printing-press-library install icloud

Hermes:

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

OpenClaw:

    clawhub install printing-press-library/icloud

## After install

Call icloud-pp-cli from the shell, or use the /pp-icloud skill inside an agent.
Run icloud-pp-cli --help to list commands.

## Links

- Documentation: https://printingpress.dev/documentation/icloud
- Library page: https://printingpress.dev/library/media-and-entertainment/icloud
- This file: https://printingpress.dev/documentation/icloud/agents.md