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 to install — resolved to @phantomagent/adapter-paperclip-facade + the runtime's exportPath subpath (e.g. ./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 | | Facade adapters | @phantomagent/adapter-paperclip-facade (one package, exportPath per runtime — e.g. ./cursor) |

Or CLI:

paperclipai plugin install @phantomagent/plugin-paperclip

Setup

1. In Phantom → Applications, use ApplicationClient paperclip-proxy (lab/hosted Nest). Create a credential and copy the secret once — do not use the retired example id paperclip-staging (it is absent from Nest).
2. Settings → Plugins → Phantom Agent — Phantom API URL (https://api.phantomagent.io) + ApplicationClient ID paperclip-proxy + secret → Save → Sync adapters
3. Settings → Adapters — install @phantomagent/adapter-paperclip-facade with exportPath: "./cursor" (or let Sync capabilities resolve this automatically)
4. Restart Paperclip control plane after installing adapters
5. Agent adapter: Cursor (Phantom Agent) (cursor_phantom_agent)

Ops detail: docs/paperclip-wiki/wiki/diagnosis/2026-07-29-paperclip-plugin-application-client-proxy.md (Phantom docs repo).

Connection settings on the plugin are applied automatically to facade adapters at run time (Paperclip defaultsFromPlugin). Per-agent connection fields are optional overrides only.

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)
  └── cursor_phantom_agent → 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.