paperclip-plugins/plugin-log-viewer/README.md

Log Viewer Plugin

A Paperclip plugin that monitors and displays agent run logs and activity in real-time.

Features

• Dashboard Widget: Shows recent log activity on the main dashboard
• Full Log Page: View all captured events with filtering
• Event Tracking: Captures:
  • Agent run started/finished/failed
  • Issue created/updated
  • Goal created
  • Agent created

Development

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

This scaffold snapshots @paperclipai/plugin-sdk and @paperclipai/shared from a local Paperclip checkout at:

/home/mike/code/paperclip/packages/plugins/sdk

The packed tarballs live in .paperclip-sdk/ for local development. Before publishing this plugin, switch those dependencies to published package versions once they are available on npm.

Install Into Paperclip

curl -X POST http://127.0.0.1:3100/api/plugins/install \
  -H "Content-Type: application/json" \
  -d '{"packageName":"/home/mike/code/paperclip_plugins/plugin-log-viewer","isLocalPath":true}'

Build Options

• pnpm build uses esbuild presets from @paperclipai/plugin-sdk/bundlers.
• pnpm build:rollup uses rollup presets from the same SDK.