CodexDash

CodexDash is a mobile-first dashboard for monitoring multiple OpenAI Codex accounts from one place.

Stack

• Frontend: React + Vite + TypeScript + Tailwind CSS + shadcn/ui-style components
• Backend: NestJS
• Database: Prisma + SQLite
• Auth: CodexDash email/password auth with JWT

What it does

• Create a CodexDash account and sign in
• Connect multiple OpenAI Codex sessions under one CodexDash account
• Refresh https://chatgpt.com/backend-api/api/codex/usage for each connected OpenAI account
• Merge numeric usage fields into one aggregate dashboard
• Inspect each connected account individually with raw API payload details

Important note about "OpenAI Codex login"

OpenAI does not expose a simple third-party OAuth flow for this usage endpoint.

This MVP implements OpenAI account connection as a session-based login flow:

1. Sign in to chatgpt.com in your browser
2. Copy the authenticated Cookie header
3. Paste it into the Connect OpenAI account dialog in CodexDash

The backend encrypts the cookie header before storing it in SQLite.

Local development

pnpm install
pnpm --filter @codexdash/api exec prisma generate
cd apps/api && DATABASE_URL=file:./dev.db pnpm exec prisma db push
cd ../..
pnpm --filter @codexdash/api start:dev
pnpm --filter @codexdash/web dev --host 0.0.0.0

Environment variables

apps/api/.env

JWT_SECRET=dev-jwt-secret-for-codexdash
ENCRYPTION_SECRET=dev-encryption-secret-for-codexdash-32chars
DATABASE_URL=file:./dev.db

apps/web/.env

VITE_API_BASE_URL=http://localhost:3001

Verification

pnpm lint
pnpm test
pnpm build
curl http://localhost:3001/health

API overview

• POST /auth/register
• POST /auth/login
• GET /auth/me
• GET /codex/accounts
• POST /codex/accounts
• DELETE /codex/accounts/:accountId
• GET /codex/usage-summary