pi-go-review

pi-go-review

Review Go code changes against the 100 Go Mistakes checklist — 100go.co

A Pi extension that registers a go_review tool. It reads git diffs, filters to .go files, and provides the complete 101-mistake rubric for the LLM to analyze your code.

Install

pi install npm:pi-go-review

Usage

Just ask Pi: "review my Go changes"

The tool supports 5 diff modes:

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

You can also narrow the scope with the path parameter to focus on a specific file or directory.

What it does

• Reads the git diff filtered to *.go files
• Attaches the full 100 Go Mistakes checklist (101 entries across 11 categories)
• The LLM produces a structured review with categorized findings:
  • 🔴 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 specific file + code fragment
• Ends with a Verdict: Approve / Request Changes / Needs Discussion

Categories covered

• 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 (#92–#101)

Custom TUI rendering

The extension includes custom rendering for both the tool call and result in Pi's TUI — showing 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