{"adoption": {"forks": 121, "observed_at": "2026-08-28T04:08:23.127687+00:00", "stars": 3829}, "canonical_url": "https://ross.abutalabs.com/products/cli-guidelines", "card": {"archived": false, "artifact_type": "learning-resource", "description": "A guide to help you write better command-line programs, taking traditional UNIX principles and updating them for the modern day.", "domain": ["developer-tools", "documentation", "tutorials"], "enriched": true, "function": ["documentation", "developer-tools", "cli"], "health_score": 70, "homepage": "https://clig.dev", "language": "CSS", "license": "CC-BY-SA-4.0", "license_family": "other", "maturity": "active", "member_repos": ["cli-guidelines/cli-guidelines"], "name": "cli-guidelines/cli-guidelines", "platform": ["cli", "cross-platform"], "pushed_at": "2026-05-16T04:37:13+00:00", "repo": "cli-guidelines/cli-guidelines", "stars": 3829, "tags": ["cli-design", "unix-philosophy", "guide", "hugo", "best-practices", "ux-writing", "command-line", "web-server"], "topics": [], "urls": [], "use_cases": ["learn how to design a good command-line interface", "guidelines for CLI argument parsing and error messages", "best practices for building developer CLI tools", "modern take on UNIX command-line principles", "checklist for reviewing a CLI tool's UX", "advice on output formatting, colors, and exit codes for CLIs"], "what_it_is": "An open-source guide (clig.dev) teaching how to write better command-line programs by updating traditional UNIX principles for modern usage. The repository contains the Markdown source of the guide and the Hugo site that publishes it.", "when_to_avoid": ["you need a library or framework that implements CLI parsing for you", "you want GUI or web UX guidelines rather than terminal-focused advice", "you need a formal specification rather than practical guidance"], "when_to_choose": ["you are building or reviewing a command-line tool and want authoritative UX guidance", "you want a concise, community-vetted reference on CLI conventions", "you need a resource to share with a team writing CLI software"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/cli-guidelines", "repo": "cli-guidelines/cli-guidelines", "role": "main", "score": 69}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:08:23.127687+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T18:26:20.200616+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "df1a8d1f6f0959b0fd032b2dee4e25347cfae2457cdde215d4ff05b9c581def3", "fetched_at": "2026-08-28T04:08:23.127687+00:00", "kind": "readme", "missing": false, "url": "https://github.com/cli-guidelines/cli-guidelines"}, {"content_hash": "881c511659656897b65891429bfcc01ae82e2ee0c40437c0c07b29ffb6a5a51c", "fetched_at": "2026-08-29T09:21:00.162310+00:00", "kind": "homepage", "missing": false, "url": "https://clig.dev"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 82, "longevity": 100, "rhythm": 35}, "computed_at": "2026-09-02T17:46:02.011165+00:00", "flags": ["no_releases"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 2321, "days_push": 109, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 69, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}