Code Revolver 🥁🔄

Revolver-style Codex account rotation: load profiles, monitor limits, switch safely.

🌐 Language / Язык: English | Русский

Code Revolver is a desktop app that manages multiple Codex auth.json profiles and rotates them when quota is low or token state is invalid.

When you work with multiple Codex accounts, manual rotation is error-prone. Code Revolver gives you:

• 🧩 a structured account pool
• 📊 quota visibility (5h + weekly windows)
• 🔁 fast manual switch and smart auto-switch

1. 📥 Put account JSON files into your local accounts directory.
2. 🔍 App scans profiles and usage status.
3. 🧠 Best candidate is ranked by priority + quota health.
4. 🎯 Manual switch or automatic rotation updates active auth file.

Requirements:

• Node.js 18+
• Rust toolchain

Development:

git clone https://github.com/Javaec/Code-Revolver.git
cd Code-Revolver
npm install
npm run tauri dev

Production build:

npm run tauri build

npm run dev
npm run lint
npx tsc --noEmit
npm run build
npx vitest run
cd src-tauri && cargo check

src/                 React + TypeScript UI
src-tauri/           Tauri backend (Rust commands)
.github/             Issue + PR templates
image/README/        README screenshots

• Never commit real account tokens.
• Use redacted/dummy auth.json in reports.
• Double-check WebDAV settings before enabling sync.

• Duplicate profile appears: verify no accidental duplicate files in accounts directory.
• 401/403 usage errors: refresh token and validate account auth state.
• WebDAV fails: check URL, app password, remote path permissions.

• CONTRIBUTING.md
• .github/ISSUE_TEMPLATE/bug_report.md
• .github/ISSUE_TEMPLATE/feature_request.md
• .github/pull_request_template.md

Code Revolver — десктопное приложение для управления несколькими профилями Codex (auth.json) и безопасной ротации аккаунтов при низкой квоте или проблемах токена.

При работе с несколькими аккаунтами ручная ротация легко приводит к ошибкам. Code Revolver даёт:

• 🧩 структурированный пул аккаунтов
• 📊 видимость лимитов (окна 5 часов и неделя)
• 🔁 быстрое ручное и умное авто-переключение

1. 📥 Поместите JSON-профили в директорию аккаунтов.
2. 🔍 Приложение сканирует профили и usage.
3. 🧠 Кандидаты ранжируются по приоритету и состоянию квоты.
4. 🎯 Переключение вручную или авто-ротация обновляют активный auth-файл.

Требования:

• Node.js 18+
• Rust toolchain

Разработка:

git clone https://github.com/Javaec/Code-Revolver.git
cd Code-Revolver
npm install
npm run tauri dev

Сборка:

npm run tauri build

npm run dev
npm run lint
npx tsc --noEmit
npm run build
npx vitest run
cd src-tauri && cargo check

src/                 UI на React + TypeScript
src-tauri/           Tauri backend на Rust
.github/             Шаблоны issue и PR
image/README/        Скриншоты

• Не коммитьте реальные токены.
• В репортах используйте только редактированные auth.json.
• Перед включением sync проверьте WebDAV-конфиг.

• Профиль дублируется: проверьте директорию аккаунтов на лишние копии файлов.
• Ошибки 401/403: обновите токен и проверьте валидность профиля.
• WebDAV не работает: проверьте URL, app password и права на удалённый путь.