Loongphy

codex-auth

A CLI tool for switching and managing Codex accounts, supporting Codex CLI, VS Code extension, and Codex App.

v0.4.0
Published at
5d ago
2,855
Stars
102
Download
Synced at
5d ago

Latest release

v0.4.0Nov 8, 2026, 06:02 AM
Downloads slow? Switch the source anytime above

README

Project Overview

codex-auth is a command-line tool for switching Codex accounts.

Key Features

  • List stored accounts and usage state
  • Login and add the current account
  • Interactively switch the active account
  • Switch directly by row number or account selector
  • Interactively remove accounts or by selector
  • Set aliases for accounts
  • Supports Codex CLI, VS Code extension, and Codex App

Target Audience

  • Codex CLI users
  • VS Code Codex extension users
  • Developers who need to switch between multiple Codex accounts

Quick Start

  1. Install globally: npm install -g @loongphy/codex-auth
  2. Or run without installation: npx @loongphy/codex-auth list
  3. Login: codex-auth login (or --device-auth for device authentication)
  4. Switch accounts: codex-auth switch
  5. List accounts: codex-auth list

Core Advantages

  • Simple and easy-to-use CLI
  • Supports multiple Codex clients
  • Open-source and free (MIT)

System Requirements

  • OS: Cross-platform (Node.js environment)
  • Architectures: x86_64, arm64
  • Additional Dependencies: Node.js, Codex CLI (recommended)

Release history

Sort