Searchgit

Search GitHub repositories with criteria and browse the results in a clean web interface (light/dark theme, responsive, English/French UI). The interface reuses the look of Logstream.

browser ──/api/search──▶ searchgit (Go) ──REST──▶ api.github.com/search/repositories
                               └── 5 min cache

Getting started

cp .env.example .env      # optional: set GITHUB_TOKEN
docker compose up -d --build

Then open http://localhost:8080.

Without Docker: go run . (Go 1.23 or newer), then open http://localhost:8080.

Criteria

Filter	GitHub qualifier
Search field	free text, plus any GitHub qualifier (user:, org:, NOT, "exact phrase", size:…)
Everywhere / Name / Description / README	in:name, in:description, in:readme
Language	language:Go (click a language in the list to filter on it)
Stars	stars:>=100
Activity	pushed:>=YYYY-MM-DD (1 month to 2 years)
Creation date	created:>=YYYY-MM-DD
License	license:mit…
Topic	topic:cli (click a topic in the list to filter on it)
Good first issues	good-first-issues:>0
Forks / Archived	forks and archived repositories are hidden unless enabled
Sort	best match, stars, forks, recently updated, help wanted issues

The filters are kept in the page URL, so a search can be bookmarked or shared. The footer shows the exact query sent to GitHub (click it to open the same search on github.com). CSV downloads the loaded results (semicolon separated when the UI is in French, for Excel).

GitHub returns at most the first 1,000 results of a search.

Configuration

Variable	Default	Role
HTTP_ADDR	:8080	listening address
GITHUB_TOKEN	empty	GitHub token; raises the search quota from 10 to 30 requests per minute
CACHE_TTL	5m	identical searches are served from memory for this long
AUTH_USER / AUTH_PASS	empty	HTTP basic authentication (except /healthz)
GITHUB_API	https://api.github.com	API base URL (GitHub Enterprise)

API

• GET /api/search?q=&in=&language=&stars=&maxstars=&minforks=&topic=&license=&pushed=&created=&goodfirst=1&forks=1&archived=1&sort=&order=&page=&per_page= (pushed / created: 1w, 1m, 3m, 6m, 1y, 2y, 5y)
• GET /api/status: token configured and last known search quota
• GET /healthz

Development

go test ./...
go run .

The web interface is plain HTML, CSS and JavaScript in web/, embedded in the binary (no build step).