> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monolex.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> Monolex - The AI-Native Terminal
# Welcome to Monolex
Monolex is a **next-generation AI-native terminal** built for the era of LLM-powered development. It combines the performance of native Rust with the flexibility of modern web technologies.
```
████
█████████████ ██████ ████████ ██████ ░░███ ██████ █████ █████
░░███░░███░░███ ███░░███░░███░░███ ███░░███ ░███ ███░░███░░███░███
░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███████ ░░░███░
░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███ ░███░░░ ███░███
█████░███ █████░░██████ ████ █████░░██████ █████░░██████ █████ █████
░░░░░ ░░░ ░░░░░ ░░░░░░ ░░░░ ░░░░░ ░░░░░░ ░░░░░ ░░░░░░ ░░░░░ ░░░░░
The AI-Native Terminal
```
***
## Why Monolex?
### The Problem
Traditional terminals weren't designed for AI workloads:
```
┌─────────────────────────────────────────────────────────────────┐
│ TRADITIONAL TERMINAL PROBLEMS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ❌ LLM Streaming Causes Crashes │
│ ───────────────────────────── │
│ ┌─────────┐ │
│ │ Claude │ ───▶ Stream 1000s of chars/sec │
│ │ Code │ ───▶ Terminal can't keep up │
│ └─────────┘ ───▶ 💥 CRASH │
│ │
│ ❌ High CPU During Fast Output │
│ ───────────────────────────── │
│ CPU: ████████████████████████████████ (100%) │
│ Fan: 🌀🌀🌀 (spinning loudly) │
│ │
│ ❌ Visual Jitter and Flickering │
│ ───────────────────────────── │
│ Screen: ▓░▓░▓░▓░▓░▓░▓░ (hurts your eyes) │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### The Solution
Monolex solves all of these with a unique architecture:
```
┌─────────────────────────────────────────────────────────────────┐
│ MONOLEX SOLUTIONS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ✓ Never Crashes │
│ ───────────────────────────── │
│ ┌─────────┐ │
│ │ Claude │ ───▶ Stream any amount │
│ │ Code │ ───▶ Monolex handles it │
│ └─────────┘ ───▶ ✅ SMOOTH │
│ │
│ ✓ Low CPU Usage │
│ ───────────────────────────── │
│ CPU: ████ (20%) │
│ Fan: 😴 (silent) │
│ │
│ ✓ Buttery Smooth Display │
│ ───────────────────────────── │
│ Screen: ████████████████ (clean, stable) │
│ │
└─────────────────────────────────────────────────────────────────┘
```
***
## Key Features
Rust backend with native VTE parser. Fast native ANSI processing.
Consumer-driven flow control designed for LLM streaming workloads.
PTY daemon survives app crashes. Sessions are recoverable.
Built on Tauri 2.0 with WebGL rendering. Beautiful and fast.
***
## How It Works
```
┌─────────────────────────────────────────────────────────────────┐
│ MONOLEX ARCHITECTURE - Simple View │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Your Programs (shell, vim, AI tools, etc.) │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────┐ │
│ │ MONOLEX ENGINE │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────┐ │ │
│ │ │ PTY │ │ Alacritty│ │ Smart│ │ │
│ │ │ Daemon │──│ VTE │──│ Diff │ │ │
│ │ │ (Rust) │ │ Parser │ │ │ │ │
│ │ └──────────┘ └──────────┘ └──────┘ │ │
│ │ │ │
│ │ ↓ 99.95% data reduction ↓ │ │
│ │ │ │
│ └────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────┐ │
│ │ xterm.js WebGL (GPU Rendering) │ │
│ │ │ │
│ │ Smooth, flicker-free, GPU-powered │ │
│ │ │ │
│ └────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
***
## What Makes Monolex Unique?
### 1. Hybrid Architecture (Alacritty + xterm.js)
We combine the **Alacritty VTE Parser** (fastest native parser) with **xterm.js WebGL** (best renderer):
```
┌─────────────────────────────────────────────────────────────────┐
│ THE BEST OF BOTH WORLDS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ ALACRITTY PARSER │ │ XTERM.JS WebGL │ │
│ │ ───────────────── │ │ ────────────── │ │
│ │ │ │ │ │
│ │ • Rust speed │ + │ • GPU power │ │
│ │ • Low memory │ │ • Beautiful fonts │ │
│ │ • Battle-tested │ │ • Modern look │ │
│ │ │ │ │ │
│ └──────────┬──────────┘ └──────────┬──────────┘ │
│ │ │ │
│ └───────────┬─────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────┐ │
│ │ MONOLEX TERMINAL │ │
│ │ ──────────────── │ │
│ │ Fast + Beautiful │ │
│ └───────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### 2. Smart Flow Control
The only terminal with **rendering-completion-based backpressure**:
```
┌─────────────────────────────────────────────────────────────────┐
│ FLOW CONTROL COMPARISON │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Other Terminals: │
│ ───────────────── │
│ │
│ Data ───▶ Parse ───▶ Render ───▶ Parse ───▶ Render ───▶ ... │
│ │
│ Problems: │
│ • Renderer gets overwhelmed │
│ • Data piles up │
│ • Eventually crashes │
│ │
│ │
│ Monolex: │
│ ───────────────── │
│ │
│ Data ───▶ Parse ───▶ ┌──────────┐ ───▶ Render │
│ │ GATE │ │ │
│ │ (waits) │ ◀──────┘ │
│ └──────────┘ "I'm ready for more" │
│ │
│ Benefits: │
│ • Renderer controls the pace │
│ • Never overwhelmed │
│ • Always smooth │
│ │
└─────────────────────────────────────────────────────────────────┘
```
### 3. Crash-Resilient Design
Your terminal session survives even if the app crashes:
```
┌─────────────────────────────────────────────────────────────────┐
│ CRASH RESILIENCE │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Traditional Terminal: │
│ ───────────────────── │
│ │
│ App crashes ───▶ Terminal dies ───▶ Work LOST 😱 │
│ │
│ │
│ Monolex: │
│ ───────────────────── │
│ │
│ ┌──────────────────────────────────────────────┐ │
│ │ PTY Daemon (separate process) │ │
│ │ ───────────────────────────── │ │
│ │ • Runs independently │ │
│ │ • Survives app crashes │ │
│ │ • Keeps your session alive │ │
│ └──────────────────────────────────────────────┘ │
│ │ │
│ App crashes ───▶ │ ───▶ Session SAFE ✅ │
│ │ │
│ App restarts ───▶ │ ───▶ Reconnect and continue! │
│ │ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
***
## Quick Start
Get Monolex from [monolex.ai](https://monolex.ai)
Drag to Applications folder (macOS)
Open Monolex and start your first terminal
***
## Learn More
Learn about Monolex features in simple, visual guides.
Get running in 5 minutes with practical examples.
Understand the technology behind Monolex's performance.
Deep dive into how Monolex is built (for developers).
***
```
╔═══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ "Consumer-driven backpressure is the missing piece in terminal ║
║ architecture for AI-native workloads." ║
║ ║
║ — The Monolex Philosophy ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════════╝
```
***
## Documentation Map
```
┌─────────────────────────────────────────────────────────────────┐
│ MONOLEX DOCS - FULL STRUCTURE │
├─────────────────────────────────────────────────────────────────┤
│ │
│ GET STARTED │
│ ├── Introduction (You are here) │
│ ├── Quickstart │
│ └── Installation │
│ │
│ ARTICLES │
│ ├── Philosophy Essays │
│ │ └── Cracked Engineer, Monotology, Monokinetics, │
│ │ Monobrain, Monograph, SMPC, OFAC, Why Terminal │
│ ├── Monokinetics / Monokist / Monotology Chapters │
│ └── Technical Analysis (so-anthropic) │
│ │
│ SO ANTHROPIC │
│ ├── Constitutional AI Flickering UX │
│ ├── The Renderer Graveyard │
│ ├── Father Like Son │
│ └── Family Motto │
│ │
│ USER GUIDE │
│ ├── Smooth Rendering │
│ ├── Why Stable │
│ └── Troubleshooting │
│ │
├─────────────────────────────────────────────────────────────────┤
│ PHILOSOPHY │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Philosophy │
│ ├── Monotology │
│ │ └── 00 Source, 01 Index, 02 Manifesto, 03 Foundations, │
│ │ 04 AI, 05 Glossary, 06 Paradox, 07 Trust, 08 SMPC, │
│ │ 09 OFAC, 10 Socratic │
│ ├── Monokist │
│ │ └── 00 Why, 01 Declaration, 02 Worldview, 03 SMPC, │
│ │ 04 OFAC, 05 Mirror, 06 AI, 07 Tools, 08 Community, │
│ │ 09 Era, 10 Future │
│ └── Monokinetics │
│ └── 00 Hermeneutics, 01 Mirror, 02 Mono vs Syn, │
│ 03 Existence, 04 Motion, 05 Practitioner, 06 Ontology, │
│ 07 Meaning, 08 Licklider, 09 Simultaneity, 10 Flow │
│ │
│ Applied Philosophy │
│ ├── Overview │
│ ├── Monokinetic Hermeneutics │
│ ├── Monolex Vision │
│ ├── Why Terminal │
│ ├── Atomic Concurrency │
│ └── Gestalt Color System │
│ ├── Core: OKLCH, CSS Variables, Golden Angle, File Types │
│ ├── Flow: OKLab Mixing, Transparency, Shadows, States │
│ ├── Interpolation: sRGB vs OKLab, Gradients, Spectrum │
│ ├── Integration: CSS Architecture, Theme Manager │
│ └── Tint: Architecture, Parameters, Einstein Arc, Rust │
│ │
├─────────────────────────────────────────────────────────────────┤
│ TECHNICAL │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Architecture │
│ ├── Introduction: Overview, Philosophy to Code │
│ ├── Core Patterns: Design Patterns, Five Patterns, Actor │
│ ├── Actors & Flow: Session Actor, ACK, State Absorber, Epoch │
│ ├── Data Flow: Data Flow, ACK Control, Timeout, Dirty Track │
│ ├── Rendering: 5-Tier Grid, Alacritty-xterm, Patterns │
│ ├── Concurrency: Patterns, Passthrough Survival │
│ └── Reference: Components, Version History, Simulation │
│ │
│ Gestalt Color │
│ ├── Core: Overview, CSS Variables, File Types, Agent Colors │
│ ├── Flow: Overview, Muted, Shadows, States, Transparency │
│ ├── Theory: Principles, Gravity Lensing │
│ ├── Interpolation: sRGB vs OKLab, Gradients, Spectrum, Git │
│ ├── Integration: CSS Architecture, Theme Manager, Decision │
│ └── Tint System: Architecture, Parameters, Warp, Inheritance │
│ │
│ Transparency │
│ ├── Core: Overview, Visualization, Data Model, Integration │
│ ├── Git Viewers │
│ │ ├── Components: Base Viewer, Dashboard, Wiki Base │
│ │ └── Analysis: Blame/Stash, Diff/Commit, Parser, Heatmap │
│ ├── Extension: Architecture, Implementation │
│ ├── Wiki Viewers: OnIt Overview/Render/State, Prepare │
│ ├── Git Backend: Overview, Implementation, Work Wiki │
│ ├── Commit Graph: Current State, Upgrade Plan │
│ └── File Watcher: Architecture, Integration │
│ │
│ Terminal Core │
│ ├── Overview, PTY Daemon, Atomic VTE Parser │
│ ├── Grid System, Buffer Model, Data Flow │
│ ├── Atomic State: Overview, Intro, Mechanics, Loop, BSU/ESU │
│ ├── Rendering: Diff, Sync, Smooth Scroll, Data Reduction, │
│ │ Cursor Pattern, Performance │
│ ├── Adaptive Timing: Overview, Pipeline, Dual Loop, Layers │
│ │ └── Internals: WebKit RAF, Tokio Tick, Buffer, Tauri IPC │
│ └── Compatibility │
│ │
│ Features │
│ ├── IME/CJK Support │
│ ├── Keyboard Scroll │
│ ├── Path Open │
│ ├── Scrollbar │
│ └── VariableMD │
│ │
│ VariableMD │
│ ├── Overview │
│ ├── Tab Manager: Lifecycle, Smart Reuse │
│ ├── Core: Architecture, Integration │
│ ├── ASCII Box: Detection/Scaling, Interaction │
│ ├── Hybrid Editor: Philosophy, State Machines │
│ ├── Git Viewers: Viewer Types, Implementations │
│ └── Styles: CSS System, Theming │
│ │
│ Database │
│ ├── Core: Overview, Relations │
│ ├── Mapping: Connection Map, File Mapping, Module Graph │
│ └── Schemas: Session, Atomic Term, NIIA Watcher, OnIt, Wiki │
│ │
│ Daemons │
│ ├── Overview │
│ ├── NIIA Watcher │
│ └── PTY Log │
│ │
│ Research │
│ ├── AI UX: AI-Native Terminal, AI-CLI Pairing │
│ ├── Analysis: Terminal Analysis, Methodology, Diagrams │
│ └── Foundations: Prior Art, Giants Quote, Game Analogy │
│ │
│ CodexMono │
│ ├── Philosophy: Philosophy, Trust Contract, 600 Units │
│ ├── Technical: CJK Unicode, Font Architecture, Glyph, Dist │
│ ├── Integration: Terminal, AI, Documentation │
│ └── Evolution: History, Trinity Integration │
│ │
└─────────────────────────────────────────────────────────────────┘
```