@arvoretech/pi-git-review-bridge

PI extension that bridges a local pi session to the git-review-cloud PR reviewer: browser comments are delivered to the agent in real time over WebSocket

Packages

Package details

extension

Install @arvoretech/pi-git-review-bridge from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@arvoretech/pi-git-review-bridge

Package: @arvoretech/pi-git-review-bridge
Version: 0.1.1
Published: Jul 13, 2026
Downloads: 281/mo · 281/wk
Author: joao.barros.arvore
License: MIT
Types: extension
Size: 33.4 KB
Dependencies: 1 dependency · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@arvoretech/pi-git-review-bridge

Local pi extension that connects your running pi session to git-review-cloud. It is the only piece that touches pi: it opens an outbound WebSocket to the cloud hub, registers your session and its GitHub repos, and turns each browser review comment into a pi.sendUserMessage(...) — so the agent answers in your terminal.

cloud hub ──(wss /ws/bridge)──► this extension ──► pi.sendUserMessage(...)

No inbound ports are opened locally. The bridge dials out to the cloud.

Commands

/review-cloud-login — GitHub device flow; stores a bridge token in ~/.config/pi/git-review-cloud.json.
/review-cloud — opens the cloud reviewer in your browser. Comments you make there arrive as user messages in this pi session.

Config

~/.config/pi/git-review-cloud.json:

{
  "cloudUrl": "https://git-review.arvore.dev",
  "bridgeToken": "…",   // written by /review-cloud-login
  "login": "you"
}

cloudUrl can also be set with the GIT_REVIEW_CLOUD_URL env var. Defaults to https://git-review.arvore.dev.

How repos are discovered

On session start the bridge scans the workspace for git repos (.git up to depth 4, pruning node_modules) and reads each origin remote to build the list of owner/name slugs it reports to the cloud. The cloud lists open PRs for those slugs (that the GitHub App is installed on).

Message formatting

The wording sent to the agent (PR context primer, single comment, thread, batch) is identical to the local @arvoretech/pi-git-review extension — the formatters are duplicated here so the cloud stays agnostic about message shape.

Install

Workspace package. Build and load like the other extensions:

pnpm --filter @arvoretech/pi-git-review-bridge build