notchmeterlisted
Install: claude install-skill Amir-Hackett/notchmeter
# Notchmeter
Notchmeter is a macOS app that shows AI coding-tool usage beside the MacBook notch. It also answers from the terminal, in JSON, without the app running and without a Keychain prompt. Use it before starting anything that will take a while, and whenever the user asks about their limits.
## When to use
- Before a long task (a large refactor, a migration, a research pass): check the Claude session and weekly windows and the advice line, and say what you found in one sentence.
- When the user asks "how much do I have left", "will this fit before the reset", "which model should I use", or "what has today cost".
- When a task is running out of quota: the advice names the tool or model with room and when the window resets.
## The command
Prefer the command-line tool when it is installed (Settings › General › *Install command line tool…* links it into `~/.local/bin` or `/usr/local/bin`):
```bash
notchmeter --json # every tool
notchmeter claude --json # one tool
```
It answers from the running app's cached report (the same object, at most a few minutes old) or its local API, and only asks the vendors when the app is not running; `notchmeter --force` reads afresh. If `notchmeter` is not on the PATH, the app's own executable is the same command under `--cli`:
```bash
/Applications/Notchmeter.app/Contents/MacOS/Notchmeter --cli --json
```
If the app is built from source instead, the path is `build/Notchmeter.app/Contents/MacOS/Notchmeter` inside the re