98/ 100 · A
Polished and well engineered. Punching above its star count.
Fast manager for Go-installed binaries in $GOBIN: update, export/import, and migrate toolsets across machines
Go581 starsApache-2.0updated today
Outstanding work. A score of 98/100 puts this repo in a very small tier of truly well-engineered open source projects.
DocumentationREADME, setup, examples, license
EngineeringTests, CI, linting, lockfiles
Project healthDescription, activity, stars, deps
What to fix first
The highest-impact improvements for this repo.
- 1CI/CDEngineeringInfo
Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
- 2Install and run instructionsDocumentationIssue
Add a .env.example listing all required environment variables so contributors know what to set up.
- 3ReproducibilityEngineeringIssue
Add a Dockerfile, .nvmrc, or .python-version to pin the runtime version and make the environment reproducible.
Detailed breakdown
Documentation
94- README100
- README is present.
- README is well structured with multiple sections.
- README includes screenshots or visuals. Great for first impressions.
- README has code examples.
- README links to a live demo or deployed app.
- README includes status badges.
- Install and run instructions90
- README documents how to install the project.
- README documents how to run the project.
- No .env.example found (−10 pts).Add a .env.example listing all required environment variables so contributors know what to set up.
- License100
- Licensed under Apache-2.0.
- Contributing guide81
- Contributing guide is detailed and thorough.
- Contributing guide includes setup/install instructions.
- Contributing guide lacks a code style section (−8 pts).Describe your linting/formatting rules and how to run them.
- Contributing guide lacks a testing section (−8 pts).Show contributors how to run the test suite (e.g. npm test, pytest, cargo test).
- Contributing guide lacks a PR workflow section (−8 pts).Explain how to fork, branch, and open a pull request so contributors know what to expect.
- Contributing guide includes code examples.
- Code of conduct present.
Engineering
99- Tests100
- Test files detected (cmd/browser_command_test.go).
- Go module github.com/nao1215/gup has test files. Run with `go test ./...`.
- CI/CD100
Not applicable?
- CI is configured (.github/workflows/build.yml).
- CI workflow runs tests.
- CI runs on pull requests, not just on pushes to main.
- CI workflow runs a lint or format check.
- Optional: add type checking to CI.Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
- CI reports or uploads test coverage.
- CI tests across multiple environments or versions.
- Linting and formatting100
- Formatting enforced (.golangci.yml).
- Reproducibility95
- Lockfile present (go.sum). Installs are reproducible.
- No Dockerfile or runtime version pin found. Adding one earns +10 pts.Add a Dockerfile, .nvmrc, or .python-version to pin the runtime version and make the environment reproducible.
- Dependabot covers 2 ecosystems (gomod, github-actions). Dependencies stay current.
- go.mod pins Go version 1.25.0.
- Issue and PR templates100
- Issue or PR templates present.
- Security policy present.
Project health
100- Dependency manifest100
- Dependency manifest found (go.mod).
- go.mod module path is fully qualified (github.com/nao1215/gup).
- go.mod specifies Go version 1.25.0.
- Repository metadata100
- Repository has a description.
- Primary language detected: Go.
- Activity100
- Actively maintained (pushed within the last month).
- 581 stars.
- Housekeeping100
- .gitignore present.
Repository health signals
Activity, community, and responsiveness at scan time
Activity
- —Commits (30d / 90d)
- 28Forks
- 67Releaseslatest 4y ago
Community
- —Community health
- —authors own >50% of commits
- 581Watchers
Responsiveness
- 6hMedian issue response
- <1hMedian PR merge time
- 1Open issues
Repository files24 root entries
- .githubGood: CI is configured (.github/workflows/build.yml).Good: Dependabot covers 2 ecosystems (gomod, github-actions). Dependencies stay current.Good: Issue or PR templates present.
- cmdGood: Test files detected (cmd/browser_command_test.go).
- doc
- e2e
- internal
- scripts
- .all-contributorsrc
- .gitignoreGood: .gitignore present.
- .golangci.ymlGood: Formatting enforced (.golangci.yml).
- .goreleaser.yml
- .octocov.yml
- CHANGELOG.md
- CODE_OF_CONDUCT.mdGood: Code of conduct present.
- CONTRIBUTING.mdGood: Contributing guide is detailed and thorough.Good: Contributing guide includes setup/install instructions.Issue: Contributing guide lacks a code style section (−8 pts).Fix: Describe your linting/formatting rules and how to run them.Issue: Contributing guide lacks a testing section (−8 pts).Fix: Show contributors how to run the test suite (e.g. npm test, pytest, cargo test).Issue: Contributing guide lacks a PR workflow section (−8 pts).Fix: Explain how to fork, branch, and open a pull request so contributors know what to expect.Good: Contributing guide includes code examples.
- doc_sync_test.go
- doc.go
- go.modGood: Dependency manifest found (go.mod).
- go.sumGood: Lockfile present (go.sum). Installs are reproducible.
- LICENSEGood: Licensed under Apache-2.0.
- main.go
- Makefile
- README.mdGood: README is present.Good: README is well structured with multiple sections.Good: README includes screenshots or visuals. Great for first impressions.Good: README has code examples.Good: README links to a live demo or deployed app.Good: README includes status badges.Good: README documents how to install the project.Good: README documents how to run the project.
- release_test.go
- SECURITY.mdGood: Security policy present.