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

punchcard-presence

v1.0.8

Published

Punchcard Discord Rich Presence and local AI usage tracking for Claude Code and Codex

Vulnerabilities

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

Links

Git

Maintainers

fysionxfysionx

Keywords

discordrich-presencepunchcardai-usagetoken-usageclaude-codecodex

Readme

Punchcard

Punchcard is a completely free, lightweight Discord Rich Presence for your Agentic Development Environments (ADEs). No API key, account, or setup is required. It shows when you are working with an ADE, how many agents are active, and how many tokens you have used.

Installing

Requires Node.js 18 or newer and the Discord desktop app.

Punchcard supports Windows, macOS, and headless Linux desktop sessions. macOS uses a native AppKit menu-bar item and a user LaunchAgent; see the macOS support guide for platform details and troubleshooting checks.

npm install -g punchcard-presence

If you would prefer to use an agent or AI, paste this:

Read https://github.com/TheFysionX/punchcard and install Punchcard.

Punchcard starts automatically after installation.

Supported platforms

  • Codex
  • Claude

Support for more ADEs is planned for the immediate future.

Features

  • Discord Rich Presence for Codex, Claude, or both at once
  • Active main-task, sidechat, Claude workflow, Deep Research, and subagent count
  • Daily and weekly token usage
  • Optional profile link on the Discord token line
  • Automatic Discord reconnection
  • Self-healing Windows tray and daemon, plus native macOS menu-bar controls and login startup
  • Local-first tracking of usage and activity

Commands

Punchcard starts automatically. These are the only commands most people may need:

| Command | Description | | --- | --- | | punchcard on | Enable and start Punchcard | | punchcard off | Stop Punchcard and remove its startup entry and Claude hooks | | punchcard quit | Close Punchcard without changing the Start with Windows setting | | punchcard connect | Open Discord if needed and reconnect Punchcard | | punchcard status | View the current connection, agent, and usage status | | punchcard restart | Restart the daemon and tray | | punchcard tray --show | Open the Windows tray panel or macOS menu-bar item | | punchcard help | Show command-line help |

Advanced Metrics

Advanced Metrics is optional, disabled by default, and distributed separately from the core presence package.

Open Punchcard from the Windows tray or macOS menu bar and click the More Metrics checkbox highlighted below.

Punchcard installs punchcard-advanced-metrics in the background. Once connected, click View profile to open your dashboard. The companion package is maintained separately and is not part of this repository.

After More Metrics is enabled, Punchcard shows a nested Show my profile in my status checkbox. It is off by default. Enabling it makes the token line in Discord clickable and sends people to your Punchcard profile. When it is off, Punchcard does not include a profile URL in the Discord activity.

To disable Advanced Metrics, clear the More Metrics checkbox in the mini dashboard.

Punchcard is independent and is not affiliated with Anthropic, OpenAI, or Discord. Released under the MIT License.

Privacy · Security · Contributing · Support