Last checked: September 25, 2026
UsageBuddy brings usage and reset information for your coding-agent accounts into one dashboard. This guide covers Codex CLI setup and the UsageBuddy connection flow.
⚠️ Important: UsageBuddy currently runs on 64-bit Windows 10 (version 1809 or later) and Windows 11. Its website says the Mac app is coming soon. The macOS Codex CLI steps below install Codex, but they do not let you run UsageBuddy on a Mac yet.
Install or update Codex CLI
UsageBuddy checks for the provider's command-line tool when you add an account. Install Codex CLI before connecting. The commands below come from OpenAI's current Codex CLI instructions.
Windows
-
Open PowerShell from the Start menu.
-
Paste this installer command and press Enter:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" -
After installation, check that Codex is available:
codex --version
macOS
-
Open Terminal from Applications > Utilities.
-
Paste the official installer command and press Return:
curl -fsSL https://chatgpt.com/codex/install.sh | sh -
Check that Codex is available:
codex --version
Updating an existing installation
Update Codex through the same method you used to install it. For an installation made with OpenAI's standalone installer, run that installer command again. For an npm installation, use npm install -g @openai/codex@latest; for Homebrew on macOS, use brew upgrade --cask codex. Then run codex --version again. Avoid installing a second copy through a different method, since your computer could keep launching the older one.
Ask an AI assistant to check it for you
You can paste this plain-English request into a coding assistant. It contains no terminal commands:
Check this computer for the official OpenAI Codex CLI. If it is missing, install the latest stable version using OpenAI's current instructions for this operating system. If it is installed, identify how it was installed, compare it with the latest version, and update it through that same installation method if needed. Do not create a second installation or change installation methods. Verify the version afterward. Report the result as “old version -> new version”; if it was missing, report “not installed -> new version,” and if it was already current, say so. End with this exact line: “Now you’re ready to connect with UsageBuddy.”
Connect Codex in UsageBuddy
-
Open UsageBuddy.
-
Click Add Account.
-
Select Codex.
-
Enter an account name. Choose a label you will recognize later, such as “Personal” or “Work.”
- Click Continue.
-
Wait for the browser to open. UsageBuddy will send you to the Codex account authorization page.
-
Sign in to the ChatGPT account you want to track. If you are already signed in to the wrong account, switch accounts before continuing.
-
Close the browser after authorization finishes.
-
Return to the UsageBuddy dashboard.
Once connected, UsageBuddy can show that account's reported usage and reset information beside your other connected accounts, so you can check them in one place.