aradotso/trending-skills/codex-console-openai-registration

---
name: codex-console-openai-registration
description: Skill for using codex-console, an integrated console for automated OpenAI account registration, login, token retrieval, batch processing, and data export with Web UI management.
triggers:
  -"set up codex-console"
  -"automate OpenAI account registration"
  -"batch register OpenAI accounts"
  -"run codex-console web UI"
  -"configure codex console database"
  -"package codex-console executable"
  -"fix OpenAI registration flow"
  -"deploy codex-console with docker"
---
 
# codex-console
 
> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.
 
codex-console is an enhanced, actively-maintained fork of [cnlimiter/codex-manager](https://github.com/cnlimiter/codex-manager). It provides a Web UI and CLI for automated OpenAI account registration, login, token retrieval, batch task management, log viewing, and data export. Key fixes include Sentinel POW solving, split register/login flows, deduplication of verification code sending, and improved page-state detection.
 
---
 
## Installation
 
### Requirements
 
-Python 3.10+
-`uv` (recommended) or `pip`
 
### Clone and Install
 

 
### Environment Configuration
 

 
Key environment variables:
 
| Variable | Description | Default |
|---|---|---|
| `APP_HOST` | Listen host | `0.0.0.0` |
| `APP_PORT` | Listen port | `8000` |
| `APP_ACCESS_PASSWORD` | Web UI access password | `admin123` |
| `APP_DATABASE_URL` | Database connection string | `data/database.db` |
 
Priority order: `CLI args > .env variables > DB settings > defaults`
 
---
 
## Starting the Web UI
 

 
Access the UI at: [http://127.0.0.1:8000](http://127.0.0.1:8000)
 
---
 
## Docker Deployment
 
### docker-compose (recommended)
 

 
Customize environment variables in `docker-compose.yml`:
 

 
### docker run
 

 
> ⚠️ Always mount `-v $(pwd)/data:/app/data` to persist database and account data across container restarts.
 
Docker environment variables:
 
| Variable | Description |
|---|---|
| `WEBUI_HOST` | Listen host (default `0.0.0.0`) |
| `WEBUI_PORT` | Listen port (default `1455`) |
| `WEBUI_ACCESS_PASSWORD` | Web UI password |
| `DEBUG` | Set `1` or `true` for debug mode |
| `LOG_LEVEL` | Log level: `info`, `debug`, etc. |
 
---
 
## Database Configuration
 
### SQLite (default)
 

 
### Remote PostgreSQL
 

 
Also supports `DATABASE_URL` env var (lower priority than `APP_DATABASE_URL`).
 
---
 
## Building Executables
 
### Windows
 

 
Output: `dist/codex-console-windows-X64.exe`
 
The built executable supports CLI arguments:
 

 
### Linux / macOS
 

 
Build troubleshooting checklist:
- Python is added to PATH
- All dependencies installed (`uv sync` or `pip install -r requirements.txt`)
- Antivirus is not blocking PyInstaller output
- Check terminal output for specific error messages
 
---
 
## Key Architectural Changes (vs upstream)
 
Understanding these helps when extending or debugging:
 
### 1. Sentinel POW Solving
 
OpenAI now enforces Sentinel Proof-of-Work validation. The original codebase passed empty values; this fork implements actual POW solving:
 

 
### 2. Split Register + Login Flow
 
Registration no longer returns a usable token directly. The flow is now:
 

 
### 3. Verification Code Handling
 
The server sends the verification code email automatically. The old logic sent a duplicate manual request, causing conflicts:
 

 
### 4. Login Page State Detection
 
Login re-entry now correctly detects page transitions and submits credentials at the right stage:
 

 
---
 
## Common Patterns
 
### Running a Batch Registration Task
 
1. Open Web UI at `http://127.0.0.1:8000`
2. Navigate to **Tasks** → **New Task**
3. Configure email service (IMAP/接码 provider), proxy settings, and batch count
4. Start the task and monitor logs in real-time via the **Logs** panel
 
### Exporting Account Data
 
Use the Web UI **Export** feature to download account credentials and tokens as CSV or JSON.
 
### Viewing Logs
 
Real-time logs are available in the Web UI. For CLI log output:
 

 
### Using a Custom Email Service
 
Set up your email接码 provider credentials in the Web UI settings panel or via environment:
 

 
---
 
## Troubleshooting
 
### Web UI not accessible
 

 
### Registration stuck or failing
 
- Ensure your proxy is configured and working
- Check logs for Sentinel POW errors — update to latest commit
- Verify email接码 service credentials are correct
 
### Database errors on startup
 

 
### PyInstaller build fails on Windows
 

 
Check for antivirus interference — whitelist the `dist/` directory during build.
 
### Token retrieval returns empty
 
This typically means the login flow is hitting a new page state. Check:
- That you're on the latest commit (login page detection is actively maintained)
- Proxy is not flagged by OpenAI
- Verification code email was received and parsed correctly
 
---
 
## Project Structure (key files)
 

 
---
 
## Attribution
 
This project is a fix-and-enhancement fork of [cnlimiter/codex-manager](https://github.com/cnlimiter/codex-manager). When publishing or redistributing, include:
 

 
**Disclaimer:** For learning, research, and technical exchange only. Comply with all platform terms of service. Users assume all responsibility for use.