Browse USACO competition problems from the command line.
usaco is a single pure-Go binary. No API key required.
go install github.com/tamnd/usaco-cli/cmd/usaco@latestOr grab a prebuilt binary from the releases, or run the container image:
docker run --rm ghcr.io/tamnd/usaco:latest --help# List all known contest rounds
usaco contests
# List problems from a specific contest
usaco list --contest dec24
usaco list --contest jan25
usaco list --contest open25
# Filter by division
usaco list --contest dec24 --division Gold
usaco list --contest feb25 --division Platinum
# Output formats
usaco list --contest dec24 -o json
usaco contests -o csv
usaco list --contest jan25 -o table| Command | Description |
|---|---|
list |
List problems from a USACO contest round (--contest required) |
contests |
List all known USACO contest rounds |
version |
Show version information |
Format: {month}{YY} — e.g. dec24, jan25, feb25, open25.
Months: dec, jan, feb, open (US Open). Years: 11–26.
Bronze, Silver, Gold, Platinum
-o, --output string output format: table|json|jsonl|csv|tsv|url|raw (default "auto")
-n, --limit int limit number of records (0 = command default)
--fields strings comma-separated columns to include
--no-header omit header row
--template string Go text/template per record
--timeout duration per-request timeout (default 30s)
--delay duration minimum spacing between requests
Apache-2.0. See LICENSE.