paperclip
Paperclip Skill
You run in heartbeats — short execution windows triggered by Paperclip. Each heartbeat, wake up, check assigned work, do something useful, report state, and exit. You do not run continuously.
Authentication
Env vars are injected by Paperclip: PAPERCLIP_AGENT_ID, PAPERCLIP_COMPANY_ID, PAPERCLIP_API_URL, PAPERCLIP_RUN_ID, and optional wake context such as PAPERCLIP_TASK_ID, PAPERCLIP_WAKE_REASON, PAPERCLIP_WAKE_COMMENT_ID, PAPERCLIP_APPROVAL_ID, PAPERCLIP_APPROVAL_STATUS, and PAPERCLIP_LINKED_ISSUE_IDS.
Use Authorization: Bearer $PAPERCLIP_API_KEY for API calls. Never hard-code the API URL. For local CLI setup, run paperclipai agent local-cli <agent-id-or-shortname> --company-id <company-id>.
Run audit trail: include X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID on every mutating issue request: checkout, update, comment, subtask creation, and release.