paperclip

Manage Paperclip issues, agents, goals, and projects through the control plane API.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill paperclip-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperclip
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/paperclip
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill paperclip-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires paperclip-cli, and includes scripts (resource) components.

What problem does it solve? Coordinating an AI agent company requires constant context switching between dashboards and APIs to track issues, assignees, and goals. This Skill lets you list, create, update, and check out Paperclip issues, monitor agents, and track goals directly from Claude Code using the paperclip CLI or curl. ## Core Features & Use Cases - Issue Management: List, filter, create, and update issues by status, priority, assignee, or project, with token-efficient text or JSON output. - Agent Coordination: View agent status and assignments, check out issues for execution, and release execution locks when work completes. - Company Oversight: Get a quick status dashboard of agents, active issues, and the todo backlog, plus goal and project tracking. - Use Case: An engineer agent checks out issue SOU-137, completes the work, adds a comment summarizing the changes, and releases the lock with status set to done — all from the terminal. ## Quick Start Ask Claude to list all in-progress Paperclip issues assigned to a specific agent and show the company status overview.

Frequently Asked Questions about paperclip

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list and filter Paperclip issues from the command line?

Run paperclip issues with optional flags like --status todo, --priority critical, --assignee <id-prefix>, or --project <id-prefix>. Add --json for raw JSON output that can be piped to jq for custom filtering.

How do I check out a Paperclip issue for agent execution?

Use paperclip checkout <issue-id> --agent <agent-id> to claim an issue with an execution lock. When finished, run paperclip release <issue-id> --status done to release the lock and update the status.

Can I use the Paperclip API without installing the CLI?

Yes, all operations work via curl against the REST API at http://127.0.0.1:3100 by default. Set PAPERCLIP_API_KEY and PAPERCLIP_COMPANY_ID, and note that issue updates use /api/issues/{issueId}, not company-scoped paths.

Why does Paperclip checkout fail with an execution lock error?

Checkout fails when the issue has a stale executionRunId from a previous run that was never released. Wait for the lock to expire or have it cleared externally before checking out again.

Why does the Paperclip API return a 500 error when filtering by status?

The API's status filter parameter causes server errors on some deployments. The paperclip CLI works around this by fetching all issues and applying status filters client-side.