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 Windows. Each package includes the CLI, daemon, and bundled providers.

Full backend installation guide ↗
Windows

Download UsageStat for Windows

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

Get Windows downloads ↗

After installation, open a new PowerShell window 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 Windows system tray. Bar uses the backend from step 1.

1. Get UsageStat Bar for Windows

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

Get Bar for Windows ↗

2. Open Bar

Launch UsageStat Bar and open it from your system tray.

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.