Automation Edition - 2026-04-16

Automate with PagePins Companion Bridge

Keep the Chrome extension flow exactly as-is, then optionally add a local automation layer that routes annotations into Codex, Cursor, and Claude workflows.

View Companion Bridge on GitHub Clone URL
  • Local-first runtime
  • MCP tools included
  • Skill-assisted triage

Privacy By Default

Your annotation data stays local to your environment.

PagePins annotation data remains in browser storage and Companion Bridge records stay in your local runtime. No public dashboard is required for this workflow, and you control which assistants can access bridge actions.

What You Get In The Package

A complete bridge layer from extension snapshots to assistant-ready actions.

Runtime

HTTP Bridge Service

Receives extension snapshots at POST /pinpoint, stores item-level records, and tracks lifecycle state changes.

Entry: src/server.js

Protocol

MCP Server

Runs local MCP stdio tools for assistants while reading from the same SQLite annotation store.

Entry: src/mcp-server.js

Workflow

Prompt-Ready Assistant Lane

Use simple prompt starters in your assistant and let MCP bridge actions happen in the background.

Focus: less setup, faster handoff

Automation Flow

The same product feedback loop, now with an optional automation lane.

  1. 1

    Capture

    Create, edit, resolve, and delete notes directly in PagePins on the live page where work is needed.

  2. 2

    Sync

    Companion Bridge ingests snapshots and tracks workflow states: pending, reviewed, and sent.

  3. 3

    Execute

    Assistants pull pending items, generate implementation-ready drafts, and keep status in sync as work progresses.

Quick Start

Clone the repo, install dependencies, and start the bridge runtime.

git clone https://github.com/darshilv/pagepins-companion-bridge.git
cd pagepins-companion-bridge
cp .env.example .env
npm install
npm run dev

Bridge URL: http://127.0.0.1:3456

Use It In Your Assistant

Once bridge runtime is active, start with one of these copy-ready prompts.

Show my pending PagePins annotations and choose the best next one to focus.
Open my current PagePins annotation, summarize the issue, and draft an implementation-ready prompt.
Review my pending PagePins inbox and write concise handoff drafts for the top 3 items.
Mark the current PagePins annotation as reviewed and provide a short implementation checklist.

Need Assistance?

For setup support, contact ztnbqfspcs@privaterelay.appleid.com.