whatisgithub

What is codexu?

shanggqm/codexu — explained in plain English

Analysis updated 2026-05-18

295SwiftAudience · developerComplexity · 3/5Setup · easy

In one sentence

A macOS menu bar app that tracks OpenAI Codex and Claude Code usage quotas, token counts, and daily tasks in one place.

Mindmap

mindmap
  root((codexU))
    What it does
      Tracks Codex quota
      Tracks Claude Code usage
      Shows AI leadership score
      Displays daily tasks
    Tech stack
      Swift
      macOS
      SQLite
    Use cases
      Check quota reset time
      Monitor token usage
      Review agent coordination
    Audience
      Codex CLI users
      Claude Code users
      ChatGPT Pro subscribers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check remaining Codex quota and reset time without opening a browser

USE CASE 2

Track daily and monthly token usage across Codex and Claude Code

USE CASE 3

See an AI leadership score based on how many agents you have coordinated

USE CASE 4

Review which tools and skills you have used most recently

What is it built with?

SwiftmacOSSQLite

How does it compare?

shanggqm/codexuantiwork/chromelessolegsotnikov/sallyport
Stars295264329
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity3/51/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS Gatekeeper approval on first launch since it is distributed outside the App Store.

So what is it?

codexU is a macOS menu bar and desktop application built to help developers monitor their OpenAI Codex and Claude Code usage in one place. It shows how much of your usage quota you have left, when it resets, how many tokens you have used today, and what tasks are currently active, all without needing to open a browser or terminal. The app is aimed at people who use OpenAI Codex, Codex CLI, or the Codex desktop app regularly, especially those on ChatGPT Pro or Team plans who want a quick view of their five hour and seven day quota windows. It also supports users who split their work between Codex and Claude Code and want a single window that combines both. Beyond quota tracking, codexU includes a feature the developer calls an AI leadership score. It looks at how many AI agents you have directed over a rolling 28 day period, how long those agents worked, and how well you coordinated multiple agents running at once. The score is calculated using only verifiable local data, such as agent start and stop times and parent child relationships, and everything is processed on your Mac. No usage data, session logs, or account information is uploaded anywhere. The interface includes a color coded usage ring, a menu bar summary, a heat map of token use over the past six months, project rankings, and a list of which tools and skills you have used most. You can resize the main window, choose between several color themes, and set a keyboard shortcut to show or hide it. codexU requires macOS 13 or later and a working Codex installation that has been used at least once. Claude Code tracking is optional and reads local transcript files if you choose to enable it. It is distributed as a downloadable DMG file from GitHub Releases rather than the Mac App Store, so the first time you open it you need to manually approve it in System Settings. Building from source requires the Xcode Command Line Tools.

Copy-paste prompts

Prompt 1
Help me build a macOS menu bar app in Swift that reads local JSON files and shows usage stats
Prompt 2
Explain how to read a local SQLite database file to extract token usage history
Prompt 3
Show me how to build a keyboard shortcut recorder in a macOS SwiftUI app
Prompt 4
Walk me through packaging a Swift macOS app into a signed DMG for distribution

Frequently asked questions

What is codexu?

A macOS menu bar app that tracks OpenAI Codex and Claude Code usage quotas, token counts, and daily tasks in one place.

What language is codexu written in?

Mainly Swift. The stack also includes Swift, macOS, SQLite.

How hard is codexu to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codexu for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.