v1.0.0 // NO DEPENDENCIES

STOP THE
TERMINAL
MADNESS

A tiny, dependency-free Web UI that wraps your local Codex CLI. Streaming. Resumable. Sanity-saving.

⚠️ WARNING: TERMINAL CORRUPTION DETECTED // SYSTEM OVERLOAD // SCROLLBACK UNREADABLE // ⚠️ WARNING: TERMINAL CORRUPTION DETECTED // SYSTEM OVERLOAD // SCROLLBACK UNREADABLE //

THE ORIGIN STORY

It started with a simple `codex` command. It ended in tears.

Lines overwriting lines. Output looking like ASCII art gone wrong. The "Terminal Terror."

"I squinted at my screen. My terminal squinted back. We both knew this relationship wasn't working."

We built Codex WebUI in a 7-hour caffeine-fueled marathon to fix what was broken. No clouds. No drama. Just clean output.

$ codex "fix this mess"
Analyzing...
^[[2K^[[1GFound issue in l^[[31mine 45...
Wait, n^[[1A^[[2Kre-rendering...
ERROR: BROKEN PIPE
G
[System] Connection lost.
SEGFAULT
FAILURE

CORE PHILOSOPHY

0

Zero Dependencies

No node_modules bloat. No build steps. Just a single-file Node.js server and vanilla JS. Easy to audit, impossible to break.

L

Local First

Your data stays on your machine. Sessions stored in ~/.codex/. No telemetry. No cloud sync. Privacy by default.

S

Simple & Raw

Uses native ES Modules and HTTP/SSE. We trade complex frameworks for raw, understandable code you can hack yourself.

THE
TOOLKIT

Everything you need to stop fighting your tools and start shipping code.

📡

SSE Streaming

Real-time character-by-character output. Watch the AI think, just like in the movies, but readable.

💾

Auto-Resume

Picks up exactly where you left off from your rollout-*.jsonl files. Never lose context.

🧠

Memory Mgr

Visual interface to peek at or purge the AI's long-term memory facts. Keep it smart.

🔒

Secure

Binds to 127.0.0.1. CORS locked. Optional Token Auth. Your machine is your castle.

SYSTEM BLUEPRINT

CLIENT

Browser UI

index.html + vanilla JS

  • EventSource (SSE)
  • DOM Manipulation
  • State Management
SERVER

Node.js

server.js (Native)

  • HTTP API Routes
  • Process Spawning
  • File I/O
CORE

Codex CLI

Child Process

  • Stdin / Stdout
  • AI Inference
  • Session JSONL
Data Flow: HTTP/SSE Stdin/Stdout Pipe

CHOOSE YOUR WEAPON

NATIVE CLI

📺
  • Works over SSH
  • Scriptable
  • Visual History
  • Clean Streaming
  • Clickable Config
"Good for bots."
RECOMMENDED

WEB UI

  • 🚀 Visual Session Mgr
  • 🚀 Readable Scrollback
  • 🚀 Memory Editor
  • 🚀 Theme Toggles
  • 🚀 Full CLI Compat
"Good for humans."

API REFERENCE

GET /events

Server-Sent Events stream. Returns JSON deltas for real-time output.

POST /message

Sends prompt to current session. {"message": "string"}

POST /resume

Resumes from rollout file. {"rollout": "path/to/file.jsonl"}

DEL /memory

Purges long-term memory file. Irreversible.