Codex Profiles

Codex Profiles

<strong>A native macOS menu bar app for your Codex profiles.</strong>

Open separate ChatGPT windows, check Codex quota and get back to your projects.



<strong>Build the macOS app »</strong>
&middot;
App guide
&middot;
CLI

Actual AppKit view with sample quota values. Light and dark appearance follow macOS.

Table of contents

• About the project
• Getting started
• Usage
• How separation works
• Command-line usage
• Roadmap
• Contributing
• License
• Contact
• Acknowledgements

About the project

Keep personal, work and client profiles within reach. Codex Profiles.app lets you open ChatGPT windows side by side or launch Codex in Terminal, with a profile's quota and project shortcuts in the same menu.

In the menu	What you can do
Profiles	Create a profile and open it in ChatGPT or Terminal, with no project folder required.
Codex quota	See remaining CLI limits, low-quota warnings and reset times for each profile.
Projects	Bind folders to profiles, pin favourites and find them with search or keyboard shortcuts.

The app bundles the codex-profile CLI engine. Both use the same profiles and project bindings. This is a community project, unaffiliated with OpenAI.

Built with

Swift and AppKit for the native macOS interface, Bash and standard system tools for profile operations. The app follows macOS appearance, accent colours and accessibility preferences.

Getting started

Build from source for now. A signed app download is planned. npm and Homebrew install the CLI only.

Prerequisites

• macOS 13+, on Apple silicon or Intel.
• Xcode Command Line Tools with Swift. Install with xcode-select --install.
• The official ChatGPT desktop app for ChatGPT windows. Terminal launches and quota readings need the official Codex CLI, installed separately or available inside ChatGPT.

Installation

git clone https://github.com/Ducksss/codex-profiles.git
cd codex-profiles
make menu-app
open build/macos

Drag Codex Profiles.app to Applications, then open it. The app includes this project's CLI, so no separate npm or Homebrew installation is needed.

Local builds are unsigned development builds. For a DMG, signing and notarisation, see the macOS build guide.

Usage

Open your first profile

1. Click the menu bar icon. Existing profiles appear automatically.
2. Choose New profile… in the gear menu, or Create profile… if the list is empty. Give it a name such as personal or work.
3. Select ChatGPT, click Open beside the profile and sign in inside that window when prompted. Choose Terminal to start Codex CLI instead.

Different names can stay open side by side. Reopening a name keeps its local data, and default opens your normal ChatGPT session. Enable Open at Login in the gear menu to keep the app available after you log in.

Check quota before opening a profile

Codex left shows remaining CLI quota. Low readings turn orange or red and show their reset time. Hover for details or press ⌘R to refresh.