@estebanforge/pi-go-review

Go code-review tool for Pi. Grades your git diffs against the 100 Go Mistakes rubric (https://100go.co/) and returns categorized findings (Bug / Suggestion / Nit / Good pattern) with an Approve or Request-Changes verdict. Not a linter; pairs with go vet a

Packages

Package details

extension

Install @estebanforge/pi-go-review from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@estebanforge/pi-go-review
Package
@estebanforge/pi-go-review
Version
1.0.0
Published
Jun 20, 2026
Downloads
not available
Author
estebanforge
License
MIT
Types
extension
Size
21.1 KB
Dependencies
0 dependencies · 4 peers
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

@estebanforge/pi-go-review

Go code review against the 100 Go Mistakes checklist (100go.co). Registers a go_review tool that reads git diffs, filters to .go files, and attaches the full rubric (100 numbered mistakes + 1 community entry) for the LLM to review against.

Install

pi install npm:@estebanforge/pi-go-review

Usage

Ask Pi: "review my Go changes."

The tool runs git in one of five modes:

Mode Description Needs ref
working Unstaged changes No
staged Staged (cached) changes No
all All changes vs HEAD No
commit A specific commit Yes (SHA)
range A commit range Yes (e.g. main..HEAD)

Narrow scope with path (a file or directory).

What it does

  1. Reads the git diff filtered to *.go.
  2. Attaches the full 100 Go Mistakes checklist (100 numbered mistakes + 1 community entry, 11 categories).
  3. The LLM reviews the diff and returns categorized findings:
Severity Meaning
Bug / Critical Must fix
Suggestion Should consider
Nit Minor improvement
Good pattern Well done

Each finding cites the mistake number (e.g. #39) and the file + code fragment. Ends with a Verdict: Approve / Request Changes / Needs Discussion.

Categories covered

Section Mistakes
Code & Project Organization #1–#16
Data Types #17–#29
Control Structures #30–#35
Strings #36–#41
Functions & Methods #42–#47
Error Management #48–#54
Concurrency: Foundations #55–#60
Concurrency: Practice #61–#74
Standard Library #75–#81
Testing #82–#91
Optimizations #91–#100

TUI rendering

Custom rendering for both the tool call and its result: mode, file count, insertions/deletions, and truncation status at a glance.

Credits

Based on 100 Go Mistakes and How to Avoid Them by Teivah.

License

MIT