by Ducksss
Named CODEX_HOME profiles and ChatGPT Desktop windows with separate local state, without copying tokens
# Add to your Claude Code skills
git clone https://github.com/Ducksss/codex-profilesGuides for using cli tools skills like codex-profiles.
Last scanned: 8/23/2026
{
"issues": [
{
"file": "README.md",
"line": 80,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/Ducksss/codex-profiles/main/install\"",
"severity": "low"
},
{
"file": "README.md",
"line": 423,
"type": "dangerous-command",
"message": "Dangerous command (recursive delete of home/root): \"rm -rf \"$HOME\"",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-08-23T04:35:56.470Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how codex-profiles compares with popular alternatives.
codex-profiles is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Ducksss. Named CODEX_HOME profiles and ChatGPT Desktop windows with separate local state, without copying tokens. It has 195 GitHub stars.
Yes. codex-profiles passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Ducksss/codex-profiles" and add it to your Claude Code skills directory (see the Installation section above).
codex-profiles is primarily written in Shell. It is open-source under Ducksss on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codex-profiles against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
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.
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.
The app is built on your Mac, in one command. There is no signed download
yet. codex-profile menu install builds the app from its release source and
installs it, with no clone needed. macOS does not quarantine an app built on
the same Mac, so Gatekeeper lets it open.
Prefer the terminal? Install the CLI with
brew install Ducksss/tap/codex-profile or npm install -g codex-profile
and follow its quick start on macOS or Linux.
xcode-select --install.
Xcode itself is not needed.brew install Ducksss/tap/codex-profile
codex-profile menu install
Without Homebrew, run npx -y codex-profile@latest menu install, or install
the CLI another way first.
The build takes a few minutes. It installs Codex Profiles.app in
Applications, or in ~/Applications if you cannot write to
Applications, and replaces an earlier copy where it is. Open it from Spotlight
or Applications. The app bundles the same codex-profile version, so it needs
no separate CLI. After upgrading the CLI, run codex-profile menu install
again to rebuild the app at the new version.
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.
Local builds are unsigned and meant only for the Mac that built them. For a DMG, signing and notarisation, see the macOS build guide.
personal or work.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.
Each profile shows the remaining CLI quota of its tightest window beside a ring. Low readings turn orange or red and show their reset time, and the profile's ⋯ menu lists every window. Hover for details or press ⌘R to refresh.
The menu bar icon gains a badge when a profile runs low. Turn on Quota in menu bar in the gear menu to see the lowest remaining percentage beside the icon, or Low-quota alerts for a notification when a profile crosses into low or critical. Both are off by default, and the app never switches profiles for you.
Give each profile its own colour and symbol with Appearance… in its ⋯
menu, or codex-profile appearance work --color teal, so work and personal
are easy to tell apart. The shell prompt, Raycast and new launchers use the
same colour. To delete a profile you no longer need, use Remove profile…
in its ⋯ menu, or codex-profile remove <profile>.
For an unavailable reading, use Sign in to Codex CLI… in that profile's actions menu, then refresh. Quota follows the profile's CLI sign-in. ChatGPT can use a different account, and the app does not compare accounts. A missing reading never prevents you from opening a profile. See the quota guide for supported accounts and troubleshooting.
Choose +, select a folder and assign a profile. The project appears under its profile; pin the ones you use often, then search and click one, or press Return, to open it. The row's ⋯ menu, or a right-click, lets you change the profile, repair a moved folder or remove the shortcut. Bindings are local metadata and do not change project files.
| Shortcut | Action |
|---|---|
| ↑ / ↓, then Return | Select and open a profile or project |
| ⌘Return or ⌘-click | Open in the other destination: Terminal, unless the gear menu's Return opens in chooses it for Return |
| ⌘1–9 | Open the corresponding visible row |
| ⌘K | Focus search |
| ⌘R | Refresh profiles, projects and quota |
| Escape | Clear search, then close the menu |
| ⌃⌥⌘P | Open the menu from any app, once Keyboard shortcut is on in the gear menu |
Opening the app again from Finder or Spotlight shows the menu. Terminal actions may request macOS Automation permission on first use. The app guide covers all controls and accessibility details.
The Raycast extension opens profiles and bound
projects in ChatGPT or Terminal and shows each profile's remaining Codex quota.
Like the menu bar app, it runs every action through codex-profile, using a
standalone install or the copy inside the menu bar app. It isn't in the
Raycast Store yet, so build it from a source checkout with Node.js. See the
extension guide.
cd raycast && npm install && npm run dev
| Profile | Codex home | ChatGPT window |
|---|---|---|
default |
~/.codex |
Your normal Desktop session |
work |
~/.codex-work |
Separate local state, including electron-user-data/ in that home |
| Any other name | ~/.codex-<name> |
Its own local state, kept when reopened |
A named window's state covers Chat, Work and Codex. CLI commands such as
cli, login, env and use select Codex state only and do not switch an
open ChatGPT window. Profiles do not inherit from default.
The tool opens the original signed ChatGPT app and does not read or copy
authentication file contents or ChatGPT cookies. Desktop launch refuses a
non-empty CODEX_ACCESS_TOKEN override. Local-state separation is not an
account, OS or server-side security boundary. Use separate OS users for a
stronger boundary. Read the security model and
configuration-sharing guide.
The same profiles work from the terminal on macOS and Linux. You