pi-comview

Pi package providing /review command powered by bundled comview binaries

Packages

Package details

extension

Install pi-comview from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-comview
Package
pi-comview
Version
0.1.0
Published
May 19, 2026
Downloads
not available
Author
swairshah
License
MIT
Types
extension
Size
28.2 MB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-comview

Pi package that adds a /review command for a comview-driven review loop:

pi-comview demo

  1. Open diff in comview
  2. Add comments (i), save (:w), quit (:q)
  3. Pi automatically reads .comview/comments.json
  4. Pi addresses comments by default

Attribution

This package bundles the comview binary, originally created by rockorager. See the upstream repository for the comview source code and license.

Install

From GitHub

pi install git:github.com/swairshah/pi-comview
# or
pi install https://github.com/swairshah/pi-comview

From npm

pi install npm:pi-comview

After install, run /reload (or restart Pi).

Use

  • /review → review git diff
  • /review --staged → review git diff --staged
  • /review --all → resend all comments (ignores seen-state)
  • /review --reset → reset seen-state only

State files are per-repo:

  • .comview/comments.json
  • .comview/pi-review-state.json

Bundled comview binaries

This package ships prebuilt comview binaries in bin/ for:

  • macOS arm64
  • macOS amd64
  • Linux arm64
  • Linux amd64

The extension resolves binaries in this order:

  1. PI_COMVIEW_BIN env var
  2. bundled bin/comview-<platform>-<arch>
  3. comview from PATH

Updating bundled comview from upstream release

When a new upstream comview release is available, run:

make update
# or pin explicit tag
make update TAG=v0.2.0

This will:

  • clone upstream rockorager/comview
  • build all target binaries
  • update:
    • COMVIEW_VERSION
    • bin/comview-*
    • bin/checksums.txt
    • bin/metadata.json

Then commit and publish this package.

Publish

npm publish

After publishing, users can install with:

pi install npm:pi-comview