X Intelligence Plugin

X/Twitter intelligence plugin for Paperclip. Published as peak6-x-intelligence-plugin on npm.

Development

pnpm install
pnpm dev            # watch builds
pnpm dev:ui         # local dev server with hot-reload events
pnpm test

Plugin SDK types come from packed tarballs in .paperclip-sdk/.

Publishing

CI publishes automatically on version tags:

npm version patch    # or minor/major
git push && git push --tags
# CI: build → test → npm publish → trigger paperclip-deploy → Cloud Run updated

Install Into Paperclip (local dev)

curl -X POST http://127.0.0.1:3100/api/plugins/install \
  -H "Content-Type: application/json" \
  -d '{"packageName":"/path/to/x-intelligence-plugin","isLocalPath":true}'

Agent Integration

Agents access plugin data via bridge endpoints using their $PAPERCLIP_API_KEY:

POST /api/plugins/{pluginId}/bridge/data   — {"key": "corpus", "params": {"date": "YYYY-MM-DD"}}
POST /api/plugins/{pluginId}/bridge/data   — {"key": "dashboard-summary", "params": {}}
POST /api/plugins/{pluginId}/bridge/action — {"key": "trigger-discovery", "params": {}}

Skills in attention-machine teach agents how to use these tools — x-research for ad-hoc queries, daily-intelligence for the corpus workflow.

Deployment

Deployed via peak6-labs/paperclip-deploy. Deploy CI pulls the latest version from npm at build time.