usagestat.
GitHub
UsageStat/Install

MAKE YOURSELF AT HOME.

Install UsageStat.
Find your flow.

Start with the backend, connect your providers, then add Bar to keep your usage in sight. Find your setup for Windows, macOS, or Linux.

Start with the backend ↓Already have UsageStat? Add Bar ↓

Choose your operating system.

01

Install the backend

Get UsageStat for macOS. Each package includes the CLI, daemon, and bundled providers.

Full backend installation guide ↗
macOS

Download UsageStat for macOS

Choose the macOS download and follow the installation steps included with it.

Get macOS downloads ↗

After installation, open Terminal and check the CLI and providers:

TERMINAL
usagestat --version
usagestat list
02

Connect your providers

Sign in to a supported provider CLI or app, or configure its credentials. Then check your first provider.

Find your provider and sign-in method ↗
TERMINAL
usagestat list
usagestat config validate
usagestat usage claude

This example checks Claude. Replace claude with an installed provider ID.

Want the local dashboard and HTTP API?

Add the providers you want to poll to your UsageStat configuration:

TERMINAL
[[providers]]
id = "claude"
enabled = true

Start the daemon in a terminal and leave it running:

TERMINAL
usagestatd

Then open the dashboard from another terminal:

TERMINAL
usagestat dashboard

The dashboard opens at http://127.0.0.1:6736/dashboard.

03 OPTIONAL

Add Bar to your desktop.

Keep your usage in the macOS menu bar. Bar uses the backend from step 1.

1. Get UsageStat Bar for macOS

Choose the macOS app and follow the steps included with the download.

Get Bar for macOS ↗

2. Open Bar

Launch UsageStat Bar and open it from your menu bar.

3. Make it yours

Open preferences to select your providers, usage windows, and appearance. Bar reads the UsageStat backend installed in step 1; set its CLI path in preferences if needed.

Try the Linux desktop demos ↗

A note on compatibility. Bar requires a working backend and the dependencies for your selected integration. Check desktop support.