explaingit

licoy/codex-runway

Analysis updated 2026-05-18

★ 76SwiftAudience · developerComplexity · 3/5Setup · easy

TLDR

A macOS menu bar app that tracks OpenAI Codex usage quotas, estimated API costs, and lets you manage and switch between multiple Codex accounts.

Mindmap

mindmap
  root((Codex Runway))
    What it does
      Tracks Codex quota
      Manages multiple accounts
      Estimates API cost
      Shows recent sessions
    Tech stack
      Swift
      macOS
    Use cases
      Check quota reset status
      Switch accounts safely
      Estimate usage cost
    Audience
      Codex CLI users
      Multi-account developers

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 whether today's rate limit has reset

USE CASE 2

Manage and safely switch between multiple Codex accounts from the menu bar

USE CASE 3

Estimate what your local Codex usage would cost under standard API pricing

USE CASE 4

Review recent Codex sessions and projects at a glance

What is it built with?

SwiftmacOS

How does it compare?

licoy/codex-runwayinsidegui/twomillionkitdennykim123/claude-codex-battery
Stars767579
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity3/52/52/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

The release is not notarized by Apple, so macOS may block it on first launch until manually approved.

In plain English

Codex Runway is a native macOS menu bar app for people who use OpenAI Codex and want an easy way to keep an eye on how much of their usage quota is left. It sits in the menu bar and shows your remaining Codex credits, your five hour and weekly quota windows, and whether today's rate limit has reset yet, using a public third party status site as the source for that reset information. A key feature is multi account management. You can log in through the browser, import your local Codex credentials file, paste in a token or session JSON, or import an API key directly. Once you have added multiple Codex accounts, the app lets you switch between them safely, writing the selected account's credentials back to your local Codex configuration file so that the Codex command line tool and any connected editor stay in sync. Beyond quota tracking, Codex Runway estimates what your local usage would cost if billed through the regular API, broken down by today, the current billing period, the previous period, the current month, or a custom date range you choose. It builds a local index of your Codex session logs to speed up these cost calculations, and also shows a list of your recent Codex sessions, projects, and usage summaries. On privacy, the README states that account tokens are stored only in a local, permission restricted folder, and that credentials are written back to the official Codex configuration file only when you actively switch accounts. Token values are kept out of logs, issue templates, and diagnostic output. The update checker only fetches version information and does not upload any account or session data. The app requires macOS 12 or later and works best if you already have Codex installed and have used it at least once. It is distributed as a downloadable zip file from GitHub Releases rather than the Mac App Store, and since the release is not notarized by Apple, macOS may initially block it from opening until you approve it manually in system settings. It can also be built and run locally using the Swift package manager.

Copy-paste prompts

Prompt 1
Help me build a macOS status bar app in Swift that reads a local JSON credentials file
Prompt 2
Explain how to safely store and switch between multiple API account credentials on disk
Prompt 3
Show me how to estimate API cost from local usage logs given per-token pricing
Prompt 4
Walk me through building and running a Swift package locally with swift run

Frequently asked questions

What is codex-runway?

A macOS menu bar app that tracks OpenAI Codex usage quotas, estimated API costs, and lets you manage and switch between multiple Codex accounts.

What language is codex-runway written in?

Mainly Swift. The stack also includes Swift, macOS.

How hard is codex-runway to set up?

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

Who is codex-runway for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos