git404hub

what is codexlimits fr?

anywhere-music-player/codexlimits — explained in plain English

Analysis updated 2026-05-18

4SwiftAudience · developerComplexity · 2/5LicenseSetup · moderate

tl;dr

CodexLimits is a macOS menu bar app and widget that shows your ChatGPT Codex 5 hour and weekly usage limits at a glance.

vibe map

mindmap
  root((CodexLimits))
    What it does
      Menu bar usage display
      5 hour and weekly percent
      Color coded warnings
      WidgetKit widget
    Tech stack
      Swift
      WidgetKit
      macOS
    Use cases
      Quick usage check
      Desktop widget
      Limit warnings
    Audience
      Codex developers
      Mac users
      AI power users

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 make with this?

VIBE 1

Check your ChatGPT Codex usage percentage from the macOS menu bar without opening a browser.

VIBE 2

Add a desktop widget that shows your 5 hour and weekly Codex usage at a glance.

VIBE 3

Get a quick color coded warning when you're approaching your Codex usage limit.

what's the stack?

SwiftWidgetKitmacOS

how it stacks up fr

anywhere-music-player/codexlimitsaydahnizzy/calendar-drag-interactioncalda/spanishconjugation
Stars444
LanguageSwiftSwiftSwift
Last pushed2021-12-12
MaintenanceDormant
Setup difficultymoderateeasyeasy
Complexity2/52/51/5
Audiencedeveloperdevelopergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Xcode, an Apple Developer team, and registering a shared App Group before building.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

CodexLimits is a small macOS menu bar app that helps you keep an eye on how much of your ChatGPT Codex usage allowance you have used. Codex is OpenAI's coding assistant, and like many AI tools it has usage limits that reset over time, so this app is meant to make those limits visible at a glance instead of you having to check a website. The app lives in the Mac menu bar and shows two numbers: your usage percentage for the current 5 hour window and for the current week. Each percentage changes color between green, orange, and red depending on how close you are to hitting the limit, so you can tell your usage status without reading exact numbers. You can choose how often the app refreshes this information, picking an interval of 1, 2, 3, or 5 minutes. Beyond the menu bar display, the project also includes small and medium sized widgets built with Apple's WidgetKit framework, so the same usage information can appear on the macOS desktop or notification center alongside other widgets. To get its data, CodexLimits uses an embedded web view that logs into ChatGPT directly, then reads usage information from an internal ChatGPT web address rather than a public API, and shares that data with its widgets through what Apple calls an App Group, a way for an app and its widgets to share information safely. The app also keeps the existing macOS system localizations, meaning it should display correctly in different languages already supported by macOS. Building the app requires Xcode, an Apple Developer account to select your development team, and registering the shared App Group for both the main app and the widget target before compiling the CodexLimits build target. The README for this project is fairly short and does not go into detail about error handling, supported macOS versions, or long term maintenance plans. This project is aimed at developers who use ChatGPT Codex regularly and want a lightweight way to track their remaining usage without opening a browser. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me build CodexLimits in Xcode and set up the shared App Group for the widget.
prompt 2
Explain how CodexLimits reads my ChatGPT Codex usage data through its embedded web view.
prompt 3
How does CodexLimits color code the green, orange, and red usage percentages?
prompt 4
Walk me through adding the CodexLimits WidgetKit widget to my macOS desktop.

Frequently asked questions

what is codexlimits fr?

CodexLimits is a macOS menu bar app and widget that shows your ChatGPT Codex 5 hour and weekly usage limits at a glance.

What language is codexlimits written in?

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

What license does codexlimits use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codexlimits to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codexlimits for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.