Skip to content

sickbay stats

Show a quick codebase overview and project summary. The stats command gives you a snapshot of your project's key metrics without running a full health scan.

Usage

bash
sickbay stats [options]

Options

FlagDescriptionDefault
-p, --path <path>Project path to analyzeCurrent working directory
--package <name>Scope to a single package (monorepo only)
--jsonOutput stats as JSONfalse

Examples

View project stats

bash
sickbay stats --path ~/my-project

JSON output

bash
sickbay stats --path ~/my-project --json

Stats for a single monorepo package

bash
sickbay stats --path ~/my-monorepo --package @acme/web-app

What It Shows

The stats command displays the following information:

MetricDescription
FrameworkDetected framework (React, Next.js, Remix, etc.)
Runtimebrowser or node based on project dependencies
Package managerpnpm, npm, or yarn
Dependency countNumber of production and dev dependencies
File countTotal source files in the project
Lines of codeTotal LOC across source files
Test countNumber of detected test files
Last scoreMost recent health score from .sickbay/last-report.json

The last score field is only populated if you have previously run a scan with sickbay init set up.

Monorepo Mode

When run from a monorepo root without --package, the stats command shows an overview for each workspace package. Use --package to scope to one:

bash
sickbay stats --path ~/my-monorepo --package my-lib

Tips

  • Use sickbay stats --json in CI to log project metadata alongside health reports
  • The stats command is lightweight and fast — it reads metadata without running analysis tools

Released under the MIT License.