@agent-analytics/paperclip-live-analytics-plugin
v0.1.4
Published
Paperclip plugin for viewing live Agent Analytics signals inside a company workspace.
Readme
Agent Analytics Live for Paperclip
Live Agent Analytics inside a Paperclip company workspace.
The plugin adds a live page, dashboard widget, sidebar entry, and settings page so operators can see current traffic without leaving Paperclip.
Setup guide:
Install and set up Agent Analytics for Paperclip
Install in Paperclip
- In Paperclip, open
Settings->Plugins. - Click
Install Plugin. - Install this package:
@agent-analytics/paperclip-live-analytics-plugin- Open the plugin
Configurepage. - Connect your Agent Analytics account in the browser.
- Select one Agent Analytics project for the current Paperclip company.
Screenshot

Requirements
- An Agent Analytics account with live-read access
- A Paperclip instance with plugin support
Create or access your Agent Analytics account at agentanalytics.sh.
What ships today
page: company-level live map and evidence viewdashboardWidget: compact live status summarysidebar: left-nav entry that opens the live pagesettingsPage: browser-based login, connection status, and project selection- Worker-owned auth,
/livepolling,/streamfan-out, and company-scoped cache/state
Install from the CLI
npx paperclipai plugin install @agent-analytics/paperclip-live-analytics-pluginAfter install, finish connection from the plugin settings page.
Local development
cd paperclip-live-analytics-plugin
npm test
npm run build
npm packnpm testexercises the worker/shared logic.npm run buildproduces the Paperclip worker, manifest, and UI bundle.
Publish
cd paperclip-live-analytics-plugin
npm install
npm test
npm run build
npm publish --access publicThe package is configured for public scoped npm publishing.
Repository layout
src/worker/: auth, live polling, stream fan-out, and company-scoped statesrc/ui/: page, widget, and settings UIsrc/paperclip/: Paperclip-specific manifest and entrypointsdocs/: operator and maintainer notes
