@phantomagent/plugin-paperclip

Phantom Agent — Paperclip plugin

Package: @phantomagent/plugin-paperclip
Plugin id: phantomagent.plugin-paperclip

Orchestration layer for the Phantom Connected Application on Paperclip:

• Instance settings for Phantom API URL + ApplicationClient credentials
• Sync allowed runtime facades from GET /v1/applications/me/capabilities
• Display which facade adapter packages to install (e.g. @phantomagent/adapter-paperclip-cursor)

Product model: Applications own intent. Phantom owns execution. Pick Cursor (Phantom Agent) in the adapter dropdown — not native Cursor for governed agents.

Development

cd integrations
npm install
npm run build -w @phantomagent/plugin-paperclip
npm run test -w @phantomagent/plugin-paperclip

Watch builds:

cd packages/plugin-paperclip
npm run dev

Install into Paperclip

From the Paperclip Plugins or Adapters install UI, use the npm package name:

Package	Paperclip install
Plugin	@phantomagent/plugin-paperclip
Cursor facade	@phantomagent/adapter-paperclip-cursor

Or CLI:

paperclipai plugin install @phantomagent/plugin-paperclip

Setup

1. Settings → Plugins → Phantom Agent — Phantom API URL + ApplicationClient credentials → Sync capabilities
2. Settings → Adapters — install @phantomagent/adapter-paperclip-cursor
3. Restart Paperclip control plane after installing adapters
4. Agent adapter: Cursor (Phantom Agent) (phantom_cursor)

Local development

cd integrations
npm install
npm run build -w @phantomagent/plugin-paperclip
paperclipai plugin install /path/to/integrations/packages/plugin-paperclip

Architecture

Plugin (orchestration)
  ├── sync capabilities via @phantomagent/adapter-core
  └── display facade install list

Facade adapters (execution)
  └── phantom_cursor → POST /v1/execute/run-task on Phantom

See integrations/paperclip/TASK_PHANTOM_RUNTIME_FACADE_V1.md and docs/paperclip-wiki/wiki/concepts/paperclip-runtime-facade-adapters.md.

SDK dependency note

Build-time dependency: @paperclipai/plugin-sdk (from npm). The published tarball ships prebuilt dist/ only — install via npm in Paperclip.