codexswitch-cli 1.0.2

Install

Use npm or Bun if you want the easiest setup:

npm install -g @syntaxskills/codexswitch-cli
# or
bun install -g @syntaxskills/codexswitch-cli

Then verify the command is available:

codexswitch-cli --version
codexswitch-cli list

Other Install Options

Install the latest GitHub release directly:

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

Build from source:

cargo install --locked codexswitch-cli

Requires Rust 1.94 or newer.

Setup

codex login
codexswitch-cli save --label work

codex login
codexswitch-cli save --label personal

Switch when needed:

codexswitch-cli list
codexswitch-cli load --label work
codexswitch-cli load --label personal

Use --include-config when a profile also needs ~/.codex/config.toml, for example custom providers:

codexswitch-cli save --label third-party --include-config

Common Commands

Command	What it does
`codexswitch-cli save --label work`	Save the current `~/.codex/auth.json` as a profile.
`codexswitch-cli load --label work`	Restore a saved profile.
`codexswitch-cli list`	Show saved profiles.
`codexswitch-cli status --all`	Show active and saved profile usage.
`codexswitch-cli export --output profiles.json`	Export profiles for backup or transfer.
`codexswitch-cli import --input profiles.json`	Import profiles from an export bundle.
`codexswitch-cli doctor --fix`	Check and repair local profile storage.

Run codexswitch-cli help <command> for command-specific options.

Storage

Profiles are stored locally under:

~/.codex/codexswitch/profiles/

Auth files and export bundles contain secrets. Keep them private.

Docs

About SyntaxSkills

SyntaxSkills hosts this repository to keep maintenance continuous and community-owned. The goal is not profit; it is to keep the tool maintained beyond any single person. Contributors and maintainers are welcome to join.