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.

The important setup rule is that this is a multi-company plugin: each Paperclip company keeps its own plugin configuration and chooses its own Agent Analytics project.

Docs:

• Set up Agent Analytics for your Paperclip company
• Paperclip Live Plugin

Install in Paperclip

1. In Paperclip, open Settings -> Plugins.
2. Click Install Plugin.
3. Install this package:

@agent-analytics/paperclip-live-analytics-plugin

4. Open the plugin Configure page.
5. If the account is not set up yet, use the Paperclip setup task shown in the plugin help panel or the docs guide first.
6. Log in with your existing Agent Analytics account in the browser.
7. In that company workspace, choose the Agent Analytics project from the plugin settings page.
8. Open the company live page from the sidebar.

If you run multiple Paperclip companies, repeat those steps in each company workspace. The selected project is per company, not a single global plugin setting for the whole Paperclip instance.

Screenshot

Requirements

• An existing Agent Analytics account with live-read access
• A Paperclip instance with plugin support

First-time Agent Analytics setup for Paperclip should be driven by the Paperclip task flow in the docs guide, not by this login popup:

Set up Agent Analytics for your Paperclip company

What ships today

• page: company-level live map and evidence view
• dashboardWidget: compact live status summary
• sidebar: left-nav entry that opens the live page
• settingsPage: existing-account browser login, per-company project selection, Paperclip setup help, and advanced plugin settings
• Worker-owned auth, /live polling, /stream fan-out, and company-scoped cache/state

Install from the CLI

npx paperclipai plugin install @agent-analytics/paperclip-live-analytics-plugin

After install, finish connection and choose the Agent Analytics project from the plugin settings page for that company workspace.

Local development

cd paperclip-live-analytics-plugin
npm test
npm run build
npm pack

• npm test exercises the worker/shared logic.
• npm run build produces the Paperclip worker, manifest, and UI bundle.

Publish

cd paperclip-live-analytics-plugin
npm install
npm test
npm run build
npm publish --access public

The package is configured for public scoped npm publishing.

Repository layout

• src/worker/: auth, live polling, stream fan-out, and company-scoped state
• src/ui/: page, widget, and settings UI
• src/paperclip/: Paperclip-specific manifest and entrypoints
• docs/: operator and maintainer notes