Codex Auth Accounts Manager

Codex Auth Accounts Manager is a Tauri desktop app for managing multiple Codex/ChatGPT auth profiles across Windows, WSL, and the Codex desktop app. It is intended for people who regularly switch between workspaces, plans, and shared Codex homes and want one place to inspect account state, apply profiles, and spot runtime conflicts.

Status

This project is early-stage and currently focused on Windows + WSL workflows. The UI is usable in mock mode for exploration, but the real runtime integrations are still evolving and should be treated as work in progress.

What It Does

• Create and track multiple Codex auth profiles.
• Start and monitor ChatGPT login flows for profiles.
• Inspect Windows CLI, WSL CLI, and desktop-app runtime detections.
• Apply a selected profile to external Codex homes.
• Sync managed Windows and WSL profile homes.
• Surface recent rate-limit snapshots and activity history.

Platform Scope

• Primary target: Windows with WSL installed.
• Frontend-only mock mode works in a regular browser.
• Linux and macOS are not supported targets today.

Development Setup

Prerequisites

• Bun for package management and the documented JavaScript workflow.
• Rust stable toolchain and Cargo.
• Tauri system prerequisites for your OS: Tauri prerequisites.
• Playwright browser binaries for smoke tests:

bunx playwright install chromium

Install Dependencies

bun install

Running The App

Start the frontend in browser/mock mode:

bun run dev

Start the Tauri desktop shell:

bun run tauri:dev

Build the frontend bundle:

bun run build

Build the desktop app bundle:

bun run tauri:build

Checks

Run the TypeScript typecheck:

bun run typecheck

Run the smoke tests:

bun run test:smoke

The smoke suite runs against the mock API/browser flow, so it is useful even if you do not have a live Codex environment configured locally.

Repository Layout

• src/: React frontend, mock API, shared UI state, and components.
• src-tauri/: Tauri host, Rust commands, environment detection, persistence, and runtime integrations.
• tests/smoke/: Playwright smoke coverage for the desktop shell behavior rendered in mock mode.

Known Limitations

• The app is optimized for Windows + WSL and assumes Codex-related paths and commands that do not exist on every machine.
• Some runtime behaviors are intentionally conservative and may require manual restarts before external Codex surfaces pick up a newly applied profile.
• The repo does not yet ship a full CI/release pipeline or broader maintainer process docs.

Roadmap

• Harden runtime detection and external profile-apply flows.
• Improve profile import/sync behavior for more real-world account layouts.
• Expand automated coverage beyond the current smoke suite.
• Add clearer packaging/release guidance once the runtime workflow stabilizes.

Contributing

Start with CONTRIBUTING.md. For now, Bun is the supported package manager and Windows/WSL is the only fully intended development environment.

License

MIT