ProfileX

Profile manager for Claude Code and OpenAI Codex CLI.

ProfileX gives each tool its own isolated config directory per profile, and generates shims like claude-work and codex-personal so you can switch between accounts instantly.

---

Why

Neither Claude Code nor Codex provides built-in multi-account support. ProfileX solves this by redirecting each tool's native config directory:

• Claude Code → CLAUDE_CONFIG_DIR
• Codex CLI → CODEX_HOME

Each profile gets its own isolated directory. Auth happens naturally through the tool's normal flow on first run.

---

Install

One-command install (recommended)

curl -fsSL https://raw.githubusercontent.com/derekurban/profilex-cli/main/install.sh | bash

For Windows PowerShell:

irm https://raw.githubusercontent.com/derekurban/profilex-cli/main/install.ps1 | iex

npm

npm i -g profilex-cli

From source

go install github.com/derekurban/profilex-cli@latest

Installer options

Environment variables:

• PROFILEX_INSTALL_DIR (default: ~/.local/bin)
• PROFILEX_VERSION (latest by default, or tag like v0.1.0)
• PROFILEX_AUTO_PATH (1 by default; set 0 to disable PATH updates)
• PROFILEX_VERIFY_SIGNATURES (1 by default; set 0 to disable cosign verification)
• PROFILEX_ALLOW_SOURCE_FALLBACK (0 by default; set 1 to allow go install fallback)

---

Quick start

# Create profiles
profilex add claude personal
profilex add claude work
profilex add codex main

# Set defaults
profilex use claude work

# List profiles with auth status
profilex list

# Use the shims directly
claude-personal
claude-work
codex-main

After creating a profile, just run the shim (e.g. claude-work). You'll be prompted to authenticate on first use.

By default, new profiles share session/history storage per tool:

• Claude profiles link <profile>/projects to ~/.profilex/shared/claude/projects
• Codex profiles link <profile>/sessions to ~/.profilex/shared/codex/sessions

By default, new profiles also share skills across all tools and profiles:

• All profiles link <profile>/skills to ~/.profilex/shared/skills

Use --isolated with profilex add to keep sessions private, and --no-shared-skills to keep skills private.

---

Commands

• profilex add <tool> <profile> [--isolated] [--no-shared-skills] — Create profile + install shim
• profilex remove <tool> <profile> [--purge] — Remove profile + shim
• profilex uninstall [--purge] — Uninstall profilex binary (and optionally local profilex state)
• profilex list [--tool claude|codex] [--json] — List profiles with status
• profilex use <tool> <profile> — Set default profile
• profilex rename <tool> <old> <new> — Rename a profile
• profilex settings <subcommand> - Snapshot/apply tool-native settings presets (auth untouched)
• profilex tui - Launch interactive terminal UI
• profilex shim install [--dir <path>] — Reinstall all shims
• profilex shim uninstall [--all] [<tool> <profile>] — Remove shims
• profilex usage export [--out <file>] [--deep] — Export unified usage bundle for ProfileX-UI

Settings templates

ProfileX can capture tool-native settings from one profile (or native default) and apply them to other profiles while auth remains isolated.

# Capture current settings from source profile into preset "full-access"
profilex settings snapshot codex personal2 full-access

# Apply the preset to another profile
profilex settings apply codex full-access personal1

# Pull from native default Codex config (~/.codex)
profilex settings snapshot codex default baseline

# Apply a preset to native default Claude config (~/.claude or ~/.config/claude)
profilex settings apply claude baseline default

Current settings allowlist:

• Codex: config.toml
• Claude: settings.json

Supported native aliases: default, native, @default, @native

Unified usage export for ProfileX-UI

profilex usage export --out ./public/local-unified-usage.json --deep

This scans ProfileX-managed and stock Claude/Codex usage locations, normalizes events, maps them to profiles (or default-* buckets), and writes a single JSON bundle for ProfileX-UI.

If openclaw is available, it also attempts to ingest openclaw status --json --usage into the unified bundle.

---

Storage

Default root: ~/.profilex (or PROFILEX_HOME override)

~/.profilex/
├── state.json
├── profiles/
│   ├── claude/
│   │   ├── personal/
│   │   └── work/
│   └── codex/
│       └── main/
└── shared/
    ├── claude/
    │   └── projects/
    └── codex/
        └── sessions/

---

Testing

go test ./...
go vet ./...

---

License

MIT