paperclip-clippy-plugin
v0.1.0
Published
Paperclip plugin that replaces host toasts with a Clippy-style assistant overlay.
Maintainers
Readme
paperclip-clippy-plugin
Experimental Paperclip plugin that hijacks host toasts and re-renders them as a Clippy-style assistant bubble.
This repo is intentionally hacky. The first goal is to get the joke working from a real Paperclip plugin install, then tune the interception heuristics against the host DOM.
Installation
From a local checkout:
pnpm install
pnpm build
npx paperclipai plugin install --local "$PWD"This repository is prepared for npm publication as paperclip-clippy-plugin. Once published, the standard install flow will be:
npx paperclipai plugin install paperclip-clippy-pluginDevelopment
pnpm install
pnpm verify
pnpm verify:manualUseful scripts:
pnpm typecheckpnpm testpnpm buildpnpm pack:checkpnpm verifypnpm verify:manual
pnpm verify:manual builds the plugin, launches a disposable local Paperclip instance, installs this plugin into it, seeds a dummy company to skip onboarding, and opens Paperclip so you can trigger normal host toasts against a disposable instance.
Manual Verification
- Run
pnpm verify:manual. - Follow the live checklist printed by the command.
- Confirm there is no custom Clippy settings page content or test-trigger UI, and no visible global toolbar button.
- Trigger a few normal Paperclip actions that show host toasts.
- Confirm the native toast is hidden or flashes only briefly.
- Confirm the Clippy bubble appears automatically with the intercepted toast text.
- Confirm multiple messages are queued in order.
Optional environment variables:
PAPERCLIP_E2E_STATE_DIR: keep the Paperclip state under a repo-relative directory instead of a disposable temp dir.PAPERCLIP_E2E_PORT: preferred HTTP port for the disposable instance.PAPERCLIP_E2E_DB_PORT: preferred embedded Postgres port for the disposable instance.PAPERCLIP_E2E_OPEN_BROWSER=false: skip auto-opening the browser during scripted runs.
Release process
- CI runs from
.github/workflows/ci.ymlon pushes tomainand on pull requests. - npm publishing runs from
.github/workflows/release.ymlwhen a GitHub Release is published with a semver tag such asv0.1.0. - The release workflow stamps
package.jsonfrom the release tag, verifies the package, publishes with provenance, and syncs the checked-in version back to the target branch.
