codex-multi-profile

Name: codex-multi-profile
Author: Hung2124

Pending

Windows Codex Desktop multi-account via AuthSwap. Shared workspace, separate ChatGPT logins.

62stars

60forks

PowerShell

Installation

# Add to your Claude Code skills
git clone https://github.com/Hung2124/codex-multi-profile

Getting Started

Guides for using ai agents skills like codex-multi-profile.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

SKILL.md

README.md

Frequently Asked Questions

What is codex-multi-profile?

codex-multi-profile is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Hung2124. Windows Codex Desktop multi-account via AuthSwap. Shared workspace, separate ChatGPT logins. It has 62 GitHub stars.

Is codex-multi-profile safe to use?

codex-multi-profile's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install codex-multi-profile?

Clone the repository with "git clone https://github.com/Hung2124/codex-multi-profile" and add it to your Claude Code skills directory (see the Installation section above). codex-multi-profile ships a SKILL.md manifest, so compatible agents can discover and load it automatically.

What programming language is codex-multi-profile written in?

codex-multi-profile is primarily written in PowerShell. It is open-source under Hung2124 on GitHub, so you can review or fork the full source.

Are there alternatives to codex-multi-profile?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codex-multi-profile against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

239,787

Research-Architect impeccable-lite

name: codex-multi-profile description: >- Create, launch, and restore isolated OpenAI Codex Desktop profiles on Windows (codex1, codex2, ...) for separate ChatGPT accounts. Default ShareLive keeps history, projects, MCP, skills, and memories in ~/.codex; only auth.json is per-profile via AuthSwap. Launch MUST set env vars through a cmd wrapper. Use for Codex clone, multi-account, ShareLive, wrong-account, or AuthSwap bugs.

Codex Multi-Profile (Windows)

Unofficial helper for Codex Desktop on Windows when you need more than one ChatGPT login and still want one shared workspace.

Default: ShareLive + AuthSwap

Piece	Where it lives
Sessions, skills, MCP, memories, projects	Always `%USERPROFILE%\.codex`
Account	`profiles\<name>\auth.json`, swapped into `~\.codex\auth.json` at launch
On close	Watcher saves secondary auth back, then restores main `auth.json`
Electron UI	`--user-data-dir=profiles\<name>` (profile root, not a nested `electron\` folder)

Do not open the main Store Codex and a profile at the same time.

Why AuthSwap (not a second `CODEX_HOME`)

The Desktop app-server sometimes ignores CODEX_HOME and reads ~\.codex\auth.json anyway. A second home then shows the main account. AuthSwap puts the secondary token in the path the app actually reads.

Launch rules (verified)

Do not run executables from WindowsApps (Access Denied). Clone ChatGPT.exe first.
Entry point is ChatGPT.exe. Codex.exe exits 1.
Get-AppxPackage.InstallLocation can be empty — prefer an existing local clone.
Set both CODEX_ELECTRON_USER_DATA_PATH and --user-data-dir to the profile root.
Do not rely on Start-Process inheriting $env:CODEX_HOME. Write a .cmd with set and start.
PowerShell 5.1 Set-Content -Encoding UTF8 writes a BOM. That can invalidate config.toml. Use [IO.File]::WriteAllText(..., UTF8Encoding $false).
Never set a persistent user-level CODEX_HOME.
Never copy auth.json between machines or into git.

Paths

Item	Path
Install root	`%LOCALAPPDATA%\CodexParallelDesktop`
Shared module	`CodexMultiProfile.psm1`
Profile launcher	`Launch-CodexProfile.ps1`
Restore main	`Launch-CodexMain.ps1`
Manager	`CodexProfile.ps1` (`new`, `list`, `stop`, `shortcut`, `launch`)
Profiles	`...\profiles\<name>\`
Clone	`...\versions\<ver>\app\ChatGPT.exe`
Shared home	`%USERPROFILE%\.codex`

Commands

$root = "$env:LOCALAPPDATA\CodexParallelDesktop"

# Recommended launch (AuthSwap)
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\Launch-CodexProfile.ps1" -Name codex1

# Restore main Store Codex
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\Launch-CodexMain.ps1"

# Manager
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action new -Name codex2
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action list
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action status
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action status -AsJson
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action verify
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action stop -Name codex1
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action remove -Name codex2 -Force

Agent workflow

"Switch account / keep my data" → AuthSwap via Launch-CodexProfile.ps1.
"Create another profile" → -Action new, then launch with Launch-CodexProfile.ps1.
Wrong account in the UI → compare emails in the two auth.json files; fix launch (cmd wrapper); do not tell the user to log in again if profile auth is still valid.
Access Denied / empty path / exit 1 → clone ChatGPT.exe, never WindowsApps, never empty InstallLocation.
After editing scripts, copy CodexMultiProfile.psm1 and the launchers into %LOCALAPPDATA%\CodexParallelDesktop and into scripts\ in this skill. Launchers import the module from $PSScriptRoot.
"Is it installed / which account is active?" → -Action status (emails are masked) then -Action verify.

Poisoned profile auth

If the user opens Codex Main while a profile is still running, restore can write the main token into profiles\<name>\auth.json.

Guards already in the scripts:

Watcher / Launch-CodexMain only save profile auth when the active email differs from auth.json.__main__
Keep auth.json.secondary.bak
If profile auth is missing or equals main → bootstrap login (clear active auth, force secondary sign-in)

Do not

Copy or commit auth.json
Open main + profile ShareLive together
Launch Codex.exe or a WindowsApps path
Start-Process without an explicit cmd/CODEX_HOME
Write config.toml with Set-Content -Encoding UTF8 on Windows PowerShell 5.1

Details: docs/architecture.md, docs/troubleshooting.md.

Codex Multi-Profile

Two ChatGPT logins on Codex Desktop for Windows. One shared workspace.

A second CODEX_HOME often fails: the app-server still reads ~\.codex\auth.json and you land on the main account. This repo swaps the token the app actually reads (AuthSwap), then restores the main account when the profile window closes.

Tiếng Việt

Hero

Unofficial. Not affiliated with OpenAI. Requires Codex Desktop from the Microsoft Store.

Why this exists

What you tried	What actually happens
Copy `~\.codex` to another folder and set `CODEX_HOME`	Desktop still shows the main ChatGPT user
`Start-Process` with `$env:CODEX_HOME`	Env is often dropped; you get the wrong account
Run `ChatGPT.exe` from `WindowsApps`	Access Denied
Launch `Codex.exe`	Process exits 1

AuthSwap keeps sessions, skills, MCP, and memories in ~\.codex. Only auth.json moves.

AuthSwap flow

Install

Install Codex Desktop from the Microsoft Store and sign in once (this is the main account).
Close Codex.
Run Windows PowerShell:

git clone https://github.com/Hung2124/codex-multi-profile.git
cd codex-multi-profile
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-CodexMultiProfile.ps1

Or one line (downloads the repo zip, then runs the same installer):

irm https://raw.githubusercontent.com/Hung2124/codex-multi-profile/main/install.ps1 | iex

Use the Desktop shortcuts:

Shortcut	Does
Codex1	Secondary ChatGPT login (first run asks you to sign in)
Codex Main	Restore the original account and open Store Codex
Codex Profiles	List / create another profile

Close one Codex UI before opening the other.

Usage

$root = "$env:LOCALAPPDATA\CodexParallelDesktop"

powershell -NoProfile -ExecutionPolicy Bypass -File "$root\Launch-CodexProfile.ps1" -Name codex1
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\Launch-CodexMain.ps1"
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action new -Name codex2
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action list
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action status
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action status -AsJson
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action verify
powershell -NoProfile -ExecutionPolicy Bypass -File "$root\CodexProfile.ps1" -Action remove -Name codex2 -Force

# tests (no Codex UI required)
powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\Run-All.ps1

Agent skill

Install copies SKILL.md to:

%USERPROFILE%\.codex\skills\codex-multi-profile\
%USERPROFILE%\.cursor\skills\codex-multi-profile\

The skill tells Codex/Cursor not to launch Codex.exe, not to use WindowsApps, and not to Start-Process without a .cmd wrapper.

Safety

Does	Does not
Copies `auth.json` locally between `~\.codex` and `profiles\<name>`	Upload tokens or set a permanent `CODEX_HOME`
Clones `ChatGPT.exe` out of the Store package so it can start	Run the Store binary in-place
Restores main auth on close, and refuses to save if active email == main	Delete `~\.codex` history

Do not commit auth.json, *.bak, or launch-trace.log (the log can contain emails).

Uninstall

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Uninstall-CodexMultiProfile.ps1
# add -PurgeProfiles to delete local profile auth copies too

~\.codex is never deleted.

Docs

License

MIT. See LICENSE.