用途：paperclip-pp-cli 是面向 Paperclip AI 智能体管理平台的命令行客户端，通过 REST API 管理平台中的各类资源。
安装与验证：需先安装 CLI 再调用。安装命令为 npx -y @mvanhorn/printing-press-library install paperclip --cli-only，默认二进制位于 macOS/Linux 的 $HOME/.local/bin 或 Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin，需确保该目录在 $PATH 中。用 paperclip-pp-cli --version 验证；若报 command not found，说明运行时看不到二进制目录，验证通过前不要继续执行技能命令。
主要能力：命令覆盖 adapters、admin、agents、approvals、assets、attachments、auth、board、board-api-keys、bootstrap、cli-auth、cloud-upstreams、companies、environments、execution-workspaces、goals、health、heartbeat-runs、instance、invites、issues、labels、llms、openapi-json、plugins、projects、routine-triggers、routines、secrets、skills、teams、work-products、workspace-operations 等资源，可进行列表、获取、创建、更新、删除等操作。不确定命令时可用 paperclip-pp-cli which "<自然语言能力描述>" 按索引匹配；退出码 0 表示有匹配，2 表示无把握匹配。
认证与用法：支持三种模式，分别为 PAPERCLIP_SESSION_COOKIE（board-session）、PAPERCLIP_API_KEY（board-api-key）、PAPERCLIP_AGENT_TOKEN（agent-bearer）；CLI 自动识别，也可用 PAPERCLIP_AUTH_MODE 显式指定，或设为 none。用 paperclip-pp-cli doctor 验证配置。任意命令可加 --agent，等同 --json --compact --no-input --no-color --yes；可用 --select 过滤字段，--dry-run 预览请求，--idempotent、--ignore-missing 控制幂等与缺失行为。读取本地库或 API 的命令返回含 meta 与 results 的信封，需解析 .results 取数据、.meta.source 判断来源。路径通过 --home 或 PAPERCLIP_HOME 重定位，也支持按类型的环境变量。CLI 还带有自动学习循环，提供 recall、teach 等机制，具体用法以官方资料为准。
限制：资料未提供收费、价格、性能等细节；未完成 CLI 安装与版本验证前不应调用其命令。