trustoss-cli
v0.1.0
Published
GitHub repository health reports from trustoss.org — quality score, deep scan (CI health, vulnerabilities, bus factor) and star audit (growth curve + fake-star detection). Ships an agent SKILL.md for Claude Code and other AI coding tools.
Maintainers
Readme
trustoss-cli
GitHub repository health reports from trustoss.org, in your terminal and in your AI coding agent. Zero dependencies.
npm install -g trustoss-cliCommands
trustoss analyze sindresorhus/ky # 5-dimension health score (0-100 + grade)
trustoss deep-scan sindresorhus/ky # code substance · CI health · vulns · dependents · bus factor
trustoss star-audit sindresorhus/ky # star growth curve + fake-star audience analysisAdd --json for machine-readable output. GitHub URLs work anywhere an
owner/repo is expected.
$ trustoss star-audit sindresorhus/ky
★ 16,978 total
## star history
▁▁▂▂▂▂▂▂▂▃▃▃▃▃▃▄▄▄▄▄▄▅▅▅▅▅▅▅▆▆▆▆▆▆▇▇▇▇▇▇▇███████
2018-09 2026-07
## audience verdict
[ OK ] 67% of recent stargazers are established developers — organic interest
median: account 7.2y · 9 followers · 14 repos
## last 30 stargazers
Residenttt [active] 14 followers · 5 repos
zanmlakar [empty profile] 1 followers · 1 repos
...Agent skill
Ship the TrustOSS skill to Claude Code (or any agent that reads
.claude/skills/):
trustoss install-skill # user-level (~/.claude/skills/trustoss/)
trustoss install-skill --project # project-level (./.claude/skills/trustoss/)The SKILL.md teaches the agent when to run deep scans and star audits, how to interpret severities and fake-star signals, and how to report a verdict. Also served at https://trustoss.org/skill.md.
What the reports cover
- analyze — activity, maintenance, community, documentation, maturity; weighted overall score with letter grade.
- deep-scan — ok/warn/risk findings: tests & CI config, CI pass rate, PR merge rate, known vulnerabilities (OSV), dependent packages (deps.dev), commit concentration (bus factor), star-spike detection.
- star-audit — cumulative star growth samples plus profiles of the most recent stargazers, each classified (veteran / active / casual / newcomer / empty profile) with an overall authenticity verdict. Based on the same signals used in fake-star research — see our write-up.
Configuration
| Env var | Default | Purpose |
| --- | --- | --- |
| TRUSTOSS_URL | https://trustoss.org | Point the CLI at a self-hosted TrustOSS instance |
The public API is rate-limited to ~30 requests/minute per IP.
Development
git clone https://github.com/sairin1202/trustoss-cli.git
cd trustoss-cli
node bin/trustoss.js analyze sindresorhus/kyNo build step, no dependencies. PRs welcome.
License
MIT · contact: [email protected]
