Skip to content

windows

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

windows

README.md

CodexControl for Windows

This folder contains the Windows implementation of CodexControl.

What It Does

  • Tracks Codex account quota from local auth.json state
  • Shows live 5-hour and 7-day windows when available
  • Supports account switching, add account, refresh, reauthenticate, open folder, and remove
  • Runs as a tray app with a dashboard window
  • Persists accounts and snapshots under %APPDATA%\\CodexControl
  • Migrates local data from previous local app directories automatically
  • Syncs Codex global state and Codex Desktop session cache during account switches

Run Locally

python -m pip install -r .\windows\requirements.txt
python .\windows\CodexControlWindows.pyw

Build

powershell -ExecutionPolicy Bypass -File .\windows\build.ps1

This produces:

  • %REPO%\\windows\\dist\\CodexControl.exe

Install

powershell -ExecutionPolicy Bypass -File .\windows\install.ps1 -EnableStartup -Launch

The installer places the app under:

  • %LocalAppData%\\Programs\\CodexControl

and registers a startup shortcut so the tray app can launch hidden at sign-in.

Tests

$env:PYTHONPATH = (Resolve-Path .\windows)
python -m unittest discover .\windows\tests

Technical Notes

  • Account-switching fix details: ACCOUNT_SWITCH_FIX.md
  • The switch fix is covered by windows/tests/test_account_manager.py and windows/tests/test_codex_desktop.py