Home › Docs › Getting started

Getting started

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

Last updated: 2026-03-04 Apple Silicon macOS No API keys

Requirements

macOS 13+ on Apple Silicon.
Intel Mac and Linux desktop builds are not shipped in the current release line.
Windows support is in progress.
Internet access for login and Codex CLI usage.

Install

Download from the website or install with Homebrew:

brew install --cask hweihwang/codexuse/codexuse

Upgrade note: If you are coming from CodexUse 2.5.8 or older, redownload the current app manually once and replace the old install. Those older builds do not jump cleanly onto the current 3.x updater path in place.

Add your first profile

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

Pick a project

Choose a folder to group sessions. CodexUse organizes conversations by project, not by profile. Each workspace opens with a workspace home showing recent runs, a model picker, collaboration mode selection, and a full composer.

Pick a theme

CodexUse ships with Dark and Light themes. It follows your system preference by default, or you can lock it to one theme in Settings. All surfaces — sidebar, messages, terminal, diffs — follow the active theme. See the themes section in settings docs.

Install the CLI command

Run npm install -g codexuse-cli.
Open a new terminal tab if your shell has not refreshed PATH yet.
Verify:

codexuse --version

Where data lives

Codex CLI manages its own local config and auth files.
CodexUse keeps app data locally on your device.
Cloud sync (Pro) lets you push profiles, config.toml, and settings from your main machine (for example, MacBook) and pull them on another machine that has the CLI installed. Go to Settings → Cloud Sync or use codexuse sync push / codexuse sync pull. See the settings docs or cloud sync guide.