Update README to new Codex story

Author: ItsMeSamey

README.md

@@ -1,53 +1,49 @@
-# Codex Account Manager
+# Codex Manager
 
-Manage multiple Codex accounts from one UI: switch the active `~/.codex/auth.json`, group accounts by status, and keep an eye on usage/refresh.
+A Zig-first desktop/web account manager for Codex with typed RPC, deterministic launch modes, and automatic quota-state transitions.
 
-Built with SolidJS (frontend) + Zig (backend), rendered locally through WebUI Zig (SmallThingz/webui).
+![Zig](https://img.shields.io/badge/Zig-0.15.2+-f7a41d?logo=zig&logoColor=111)
+![Frontend](https://img.shields.io/badge/Frontend-SolidJS-2c4f7c)
+![Runtime](https://img.shields.io/badge/Runtime-WebUI_Zig-111827)
+![Modes](https://img.shields.io/badge/Modes-webview%20%7C%20browser%20%7C%20web-0f766e)
 
-## What It Does
+## ⚡ Features
 
-- Manage multiple accounts in one place (active / depleted / frozen)
-- Switch the active account instantly (updates `~/.codex/auth.json`)
-- Drag-and-drop reorder between buckets
-- Pull usage/credits and show refresh timing
-- Light/dark theme with persistence
+- Multi-account management with clear buckets: `active`, `depleted`, `frozen`.
+- Fast account switching (updates `~/.codex/auth.json`).
+- Drag-and-drop account movement across buckets.
+- Per-account usage refresh with immediate card updates.
+- Quota-driven lifecycle rules:
+  - `0` remaining quota in active => auto-move to depleted.
+  - non-zero quota in depleted => auto-move back to active.
+- Auto-refresh support for active and depleted flows.
+- Theme + UI preference persistence.
 
-## Quick Start
-
-### Dev
+## 🚀 Quick Start
 
 ```bash
 zig build dev
 ```
 
-This runs the frontend build (npm + Vite) and starts the app.
-
-### Modes
+This runs frontend build steps (TypeScript + Vite) and launches the app.
 
-- Default: desktop-ish window (Chromium app-window when available)
-- Force web mode:
+### Launch Modes
 
 ```bash
+zig build dev -- --webview
+zig build dev -- --browser
 zig build dev -- --web
 ```
 
-If the app prints a `http://127.0.0.1:...` URL, you can always open it manually in any browser.
+- `--webview`: prefer native webview surface.
+- `--browser`: prefer app-window/browser-window mode.
+- `--web`: open in a normal browser tab.
 
-## Requirements
+Default (no flag) uses ordered fallback: `webview -> browser window -> web tab`.
 
-Build-time:
-- Zig `0.15.2+`
-- Node.js `20+`
-- `npm`
+## 📦 Build / Install
 
-Runtime:
-- `curl` in `PATH`
-- `codex` CLI in `PATH`
-- A browser installed (Chromium-family recommended for the best desktop window behavior)
-
-## Build / Install
-
-Optimized local install:
+Optimized install:
 
 ```bash
 zig build install -Doptimize=ReleaseFast
@@ -60,39 +56,57 @@ Run:
 ./zig-out/bin/codex-manager --web
 ```
 
-Build the release matrix (writes to `zig-out/bin/`):
+Build release matrix:
 
 ```bash
 zig build build-all-targets
 ```
 
-## How It Works (High Level)
+## 🧰 Requirements
+
+Build-time:
+
+- Zig `0.15.2+`
+- Node.js `20+`
+- `npm`
+
+Runtime:
+
+- `curl` in `PATH`
+- `codex` CLI in `PATH`
+- Browser installed (Chromium-family recommended for desktop-window behavior)
+
+## 🧠 Architecture (At a Glance)
+
+- **Frontend**: SolidJS SPA (`frontend/`).
+- **Backend**: Zig app (`src/`) serving local UI + handling all account state mutations.
+- **Bridge**: typed WebUI RPC surface via `webuiRpc.cm_rpc(...)`.
+- **State ownership**: backend-authoritative persistence for account/view/usage data.
+
+## 🗂️ Storage
 
-- The Zig backend serves a local HTTP UI on `127.0.0.1` and exposes typed RPC.
-- The frontend calls back into Zig via `globalThis.webui.call("cm_rpc", requestJson)` (with HTTP fallback to `/rpc`).
-- Account state is stored locally; switching updates `~/.codex/auth.json`.
+Local app data directory:
 
-## Storage
+- `accounts.json` — managed account records
+- `bootstrap-state.json` — boot snapshot + UI cache
+- `ui-theme.txt` — theme selection
 
-Local app data directory files:
-- `accounts.json` (managed accounts)
-- `bootstrap-state.json` (UI bootstrap cache)
-- `ui-theme.txt` (theme selection)
+Codex auth target:
 
-Active Codex auth target:
 - `~/.codex/auth.json`
 
-## Testing
+## ✅ Testing
 
 ```bash
 zig build test
 ```
 
-## Troubleshooting
+## 🔎 Troubleshooting
 
-- UI opens but looks blank:
-  - Use the printed `http://127.0.0.1:...` URL in a browser to confirm the server is reachable.
-- `Backend RPC unavailable in this session`:
-  - Launch through the app (`zig build dev`) and make sure `/webui.js` loads.
-- Desktop window does not appear:
-  - Ensure a Chromium-based browser is installed (Chrome/Chromium/Brave/Edge).
+- App prints URL but no window appears:
+  - Open the printed `http://127.0.0.1:...` URL directly in your browser.
+- Native webview mode fails on Linux:
+  - Verify your WebKitGTK runtime/tooling for your distro.
+  - Use `--browser` or `--web` as fallback.
+- RPC bridge unavailable at startup:
+  - Ensure `webui_bridge.js` is injected and loaded by the served page.