Getting started

Install CodexUse, connect your first profile, and start a Codex CLI session.

Requirements

• macOS 13+ (Apple Silicon) or Linux ARM64.
• Windows support is coming soon.
• Internet access for login and Codex CLI usage.

Install

Download from the website or install with Homebrew:

brew install --cask hweihwang/codexuse/codexuse

Add your first profile

1. Open CodexUse and click Add profile.
2. Complete the OAuth login in your browser.
3. Name the profile (Work, Personal, Client).

Pick a project

Choose a folder to group sessions. CodexUse organizes conversations by project, not by profile.

Install the CLI command

1. Open Settings → CLI.
2. Click Install command in PATH (macOS only for now).
3. Verify:

codexuse --version

Where data lives

• Codex CLI config: ~/.codex
• CodexUse local state: hidden folder in your home directory
• Cloud sync (Pro) lets you push profiles, config.toml, and settings to the cloud and pull them on another device. Go to Settings → Cloud Sync or use codexuse sync push / codexuse sync pull. See the settings docs or cloud sync guide.