repiq

Fetch objective metrics for OSS repositories and packages. Built for AI agents that need fast, non-reasoning data retrieval for library and repository evaluation.

Role separation: repiq provides raw data. You (the agent) do the reasoning. The human makes the final decision.

Quick Start

# Fetch GitHub repo metrics
repiq github:facebook/react

# Fetch npm package metrics
repiq npm:react

# Compare multiple targets across providers
repiq github:facebook/react npm:react pypi:flask crates:serde go:golang.org/x/net

# Output as JSON for programmatic use
repiq --json github:facebook/react npm:react

Output is Markdown tables by default, grouped by provider. Use --json for structured data.

Supported Schemes

Scheme	Format	Example
GitHub	github:<owner>/<repo>	github:facebook/react
npm	npm:<package>	npm:react, npm:@types/node
PyPI	pypi:<package>	pypi:requests
crates.io	crates:<crate>	crates:serde
Go Modules	go:<module/path>	go:golang.org/x/net

Multiple targets can be passed in a single command. They are fetched in parallel.

Flags

Flag	Description
--markdown	Output as Markdown tables grouped by provider (default)
--json	Output as JSON array
--ndjson	Output as newline-delimited JSON (one object per line)
--no-cache	Bypass 24-hour disk cache and always fetch from API
--version	Print version and exit

Key Metrics by Provider

GitHub (8 metrics): stars, forks, open_issues, contributors, release_count, last_commit_days, commits_30d, issues_closed_30d

npm (5 metrics): weekly_downloads, latest_version, last_publish_days, dependencies_count, license

PyPI (7 metrics): weekly_downloads, monthly_downloads, latest_version, last_publish_days, dependencies_count, license, requires_python

crates.io (7 metrics): downloads, recent_downloads, latest_version, last_publish_days, dependencies_count, license, reverse_dependencies

Go Modules (4 metrics): latest_version, last_publish_days, dependencies_count, license

For full field descriptions and types, see references/REFERENCE.md.

Use Cases

Compare libraries for the same task

repiq github:expressjs/express github:fastify/fastify npm:express npm:fastify

Compare stars, commits_30d, weekly_downloads, and last_publish_days to assess activity and adoption.

Evaluate repository health

repiq github:some-org/some-repo

Check last_commit_days (is it maintained?), issues_closed_30d (is the team responsive?), and contributors (bus factor).

Cross-ecosystem package comparison

repiq npm:zod pypi:pydantic crates:serde

Compare equivalent packages across language ecosystems using weekly_downloads, dependencies_count, and license.

Authentication

GitHub only. Token is resolved automatically:

1. gh auth token (GitHub CLI — recommended)
2. GITHUB_TOKEN environment variable
3. Unauthenticated (60 req/hour rate limit)

Authenticated requests get 5,000 req/hour. Other providers require no authentication.

Installation

# Go install
go install github.com/yutakobayashidev/repiq/cmd/repiq@latest

# Or use Nix flake
nix run github:yutakobayashidev/repiq

Verify installation:

repiq --version

Caching

Results are cached on disk for 24 hours at $XDG_CACHE_HOME/repiq/ (typically ~/.cache/repiq/).

Use --no-cache to bypass cache reads (writes still occur for subsequent runs).

Error Handling

• Failed targets return {"target": "...", "error": "..."} — other targets still succeed.
• Exit code is 1 if any target fails, 0 if all succeed.
• Common errors: 404 (not found), rate limit exceeded, network timeout (30s).