npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

ai-hr

v0.0.3

Published

Local AI employee performance reviews for coding agents, with usage scans, API-equivalent cost estimates, and terminal report cards.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

waryawaynewaryawayne

Keywords

ai-hraihrcodexclaude-codeopencodecoding-agentsclilocal-firsttoken-usageapi-cost-estimatesusage-reporteffectnode

Readme

AI HR

Local AI employee performance reviews for coding agents.

AI HR scans local usage history from Codex, Claude Code, and OpenCode, normalizes token usage, estimates API-equivalent cost, and prints a report card for your AI coding workforce. The tone is playful, but the accounting is meant to stay clear: costs are estimates from local metadata and pricing rules, not provider invoices.

Install

AI HR runs on Node.js. The CLI uses the Effect Node platform and reads OpenCode's local SQLite database through Node's built-in SQLite support.

npx ai-hr report --since 30d

You can also install it globally:

npm install -g ai-hr
ai-hr report --since 30d

The package exposes both ai-hr and aihr as command names.

Usage

ai-hr
ai-hr scan --since 30d --sources codex,claude,opencode
ai-hr report --since 60d --format terminal
ai-hr payroll --since 30d
ai-hr leaderboard --group-by provider
ai-hr leaderboard --group-by model
ai-hr explain <session-id> --sources codex
ai-hr doctor

Useful flags:

| Flag | Default | Notes | | --- | --- | --- | | --since | 30d | Duration such as 7d, 30d, or an ISO start date. | | --until | none | Optional ISO end date. | | --sources | codex,claude,opencode | Comma-separated list, or all. | | --format | terminal | Supports terminal, markdown, json, and html for reports. | | --group-by | provider | For leaderboard: provider, model, repo, or day. |

What It Scans

AI HR reads local files and databases only:

| Source | Local path | | --- | --- | | Codex | ~/.codex/sessions | | Claude Code | ~/.claude/projects | | OpenCode | ~/.local/share/opencode/opencode.db |

Core reports do not upload transcripts or usage data. Missing local stores simply produce empty results for that source.

Reports

The terminal report includes:

  • API-equivalent cost estimate
  • monthly run-rate, or average monthly cost for 365-day windows
  • highest spending day
  • days without agent work
  • context vs generated token mix
  • employee roster by agent, including per-agent context ratio when multiple agents appear
  • last-30-days activity trend for longer windows
  • report-card grade, status, and context notes

The pricing notes section calls out approximation assumptions. Treat the totals as an API-equivalent model of local usage, not as a subscription bill or provider invoice.

Development

pnpm install
pnpm cli -- report --since 7d
pnpm build
pnpm test

The repo uses Effect 4 and keeps the Effect Language Service enabled for typecheck feedback.

Publishing

pnpm test
pnpm build
pnpm publish:npm

The build writes dist/cli.js as a Node executable, and npm publishes that built CLI plus this README and license. publish:npm runs the build before publishing publicly and ignores lifecycle scripts so the Effect language-service patch step does not run during publish.