Installation — UsageNow Docs

Requirements#

macOS 15 or later
A Mac with Codex, Claude Code, or both installed and signed in

UsageNow reads data from the AI coding tools you already use, so install and sign in to at least one of them first. You can add or remove providers at any time.

Download#

Once public builds are ready, UsageNow will be distributed through the channels below. This page will be updated as each one becomes available.

Download from usagenow.comPlanned
GitHub ReleasesPlanned
Homebrew CaskPlanned

Only use official builds

Until a channel above is marked Available, any download that claims to be UsageNow isn’t an official build. UsageNow is built from the public repository.

Build from source#

Building from source is currently the way to run UsageNow. You need Xcode 26 or later.

Clone the repository#

git clone https://github.com/usagenow/usagenow.git
cd usagenow

Open the project#

Open UsageNow.xcodeproj in Xcode.

open UsageNow.xcodeproj

Build and run#

Select the UsageNow scheme and choose Product › Run (⌘R). The UsageNow symbol appears in the menu bar. Click it to open the popover.

To build from Terminal instead:

xcodebuild -project UsageNow.xcodeproj -scheme UsageNow build

Continue with Getting Started once the app is running.

The desktop widget reads data through an App Group, and App Groups require a signing team. Builds without one work normally, but the widget only shows Open UsageNow to load usage data. To enable it, build with your own team ID:

xcodebuild -project UsageNow.xcodeproj -scheme UsageNow \
    DEVELOPMENT_TEAM=YOURTEAMID \
    USAGENOW_APP_GROUP=YOURTEAMID.group.com.usagenow.UsageNow \
    USAGENOW_APP_ENTITLEMENTS=Config/UsageNow.entitlements \
    USAGENOW_WIDGET_ENTITLEMENTS=Config/UsageNowWidget.entitlements \
    build

You can set the same four build settings once in Xcode instead. See the repository README for more.

Update a source build#

Pull the latest changes and build again:

git pull

Uninstall#

UsageNow doesn’t change any Codex or Claude Code files, so removing it leaves your tools exactly as they were.

If you added the UsageNow widget, remove it from your desktop.
If Launch at Login is on, turn it off in Settings › General so macOS removes the login item.
Click Quit in the popover, or press ⌘Q while it’s open.
Delete UsageNow.app.

To also remove UsageNow’s preferences, run:

defaults delete com.usagenow.UsageNow

Requirements#

Download#

Build from source#

Clone the repository#

Open the project#

Build and run#

Enable the widget in a local build#

Update a source build#

Uninstall#