Compatibility Matrix

MonoTerm achieves 100% compatibility with all major AI CLI tools through dual detection of BSU/ESU and cursor patterns.

Compatibility Score

┌───────────────────────────────────────────────────────────────────────┐
│  MONOTERM AI CLI COMPATIBILITY                                        │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│                    COMPATIBILITY SCORE: 100%                          │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   Claude Code      [══════════════════════════]  OK           │   │
│   │   Gemini CLI       [══════════════════════════]  OK           │   │
│   │   Aider            [══════════════════════════]  OK           │   │
│   │   Open Interpreter [══════════════════════════]  OK           │   │
│   │   Codex CLI        [══════════════════════════]  OK           │   │
│   │   Kiro CLI         [══════════════════════════]  OK           │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   Zero modifications required to any AI CLI application.              │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Detection Method by CLI

┌───────────────────────────────────────────────────────────────────────┐
│  DETECTION METHOD MATRIX                                              │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   ┌───────────────────┬───────────────────┬──────────────────────────┐│
│   │ AI CLI            │ Primary Detection │ Fallback Detection       ││
│   ├───────────────────┼───────────────────┼──────────────────────────┤│
│   │ Claude Code       │ BSU/ESU (if term) │ Cursor pattern (always)  ││
│   │ Gemini CLI        │ Cursor pattern    │ --                       ││
│   │ Aider             │ Cursor pattern    │ --                       ││
│   │ Open Interpreter  │ Cursor pattern    │ --                       ││
│   │ Codex CLI         │ BSU/ESU (native)  │ Cursor pattern           ││
│   │ Kiro CLI          │ Cursor pattern    │ --                       ││
│   └───────────────────┴───────────────────┴──────────────────────────┘│
│                                                                       │
│   Detection Priority in MonoTerm:                                     │
│   ───────────────────────────────                                     │
│                                                                       │
│   1. BSU/ESU (Mode 2026)  ->  Explicit frame boundaries               │
│   2. Cursor (Mode ?25)    ->  Implicit frame boundaries               │
│                                                                       │
│   If BSU/ESU is detected, cursor pattern is ignored for boundaries.   │
│   Cursor state changes are still passed through for visibility.       │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Detailed CLI Profiles

Claude Code (Anthropic)

┌───────────────────────────────────────────────────────────────────────┐
│  CLAUDE CODE PROFILE                                                  │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   Framework:    Ink (TypeScript)                                      │
│   Mode:         DUAL (cursor always + BSU/ESU conditional)            │
│   Detection:    BSU/ESU preferred, cursor fallback                    │
│                                                                       │
│   Behavior:                                                           │
│   ─────────                                                           │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   1. Startup: Check terminal BSU/ESU support                  │   │
│   │        │                                                      │   │
│   │        ├── Supported ────→ Enable BSU/ESU mode                │   │
│   │        │                                                      │   │
│   │        └── Not supported → Cursor pattern only                │   │
│   │                                                               │   │
│   │   2. Each render cycle:                                       │   │
│   │        │                                                      │   │
│   │        ├── If BSU/ESU enabled:                                │   │
│   │        │       BSU -> content -> ESU                          │   │
│   │        │                                                      │   │
│   │        └── Always (from Ink):                                 │   │
│   │                cursor hide -> content -> cursor show          │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   MonoTerm Strategy:                                                  │
│   - Detect BSU/ESU if present (priority 1)                            │
│   - Fall back to cursor pattern (priority 2)                          │
│   - Always compatible                                                 │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Codex CLI (OpenAI)

┌───────────────────────────────────────────────────────────────────────┐
│  CODEX CLI PROFILE                                                    │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   Framework:    Ratatui + Crossterm (Rust)                            │
│   Mode:         BSU/ESU NATIVE                                        │
│   Detection:    BSU/ESU primary                                       │
│                                                                       │
│   Unique Characteristics:                                             │
│   ───────────────────────                                             │
│                                                                       │
│   - Only AI CLI using BSU/ESU natively                                │
│   - Full-screen TUI application (not just streaming output)           │
│   - Wraps draw() calls in sync_update() explicitly                    │
│                                                                       │
│   Output Pattern:                                                     │
│   ───────────────                                                     │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   BSU start                    <- Begin sync                  │   │
│   │   cursor hide                  <- Ratatui                     │   │
│   │   [terminal content...]        <- Frame content               │   │
│   │   cursor show                  <- Ratatui                     │   │
│   │   ESU end                      <- End sync                    │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   MonoTerm Strategy:                                                  │
│   - Detect BSU/ESU (priority 1)                                       │
│   - Cursor pattern ignored for frame boundaries (nested inside)       │
│   - Optimal compatibility via explicit synchronization                │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Gemini CLI (Google)

┌───────────────────────────────────────────────────────────────────────┐
│  GEMINI CLI PROFILE                                                   │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   Framework:    Ink (fork, TypeScript)                                │
│   Mode:         Cursor pattern only                                   │
│   Detection:    Cursor pattern                                        │
│                                                                       │
│   Special Feature:                                                    │
│   ───────────────                                                     │
│                                                                       │
│   Uses alternate screen buffer in addition to cursor pattern.         │
│   Alternate buffer is screen switch, not frame boundary.              │
│                                                                       │
│   Output Pattern:                                                     │
│   ───────────────                                                     │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   enter alternate screen       <- Screen switch               │   │
│   │   cursor hide                  <- Frame start                 │   │
│   │   [terminal content...]        <- Frame content               │   │
│   │   cursor show                  <- Frame end                   │   │
│   │   ... (repeated renders)                                      │   │
│   │   exit alternate screen        <- Screen switch               │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   MonoTerm Strategy:                                                  │
│   - Detect cursor pattern for frame boundaries                        │
│   - Pass through alternate buffer sequences (not frame related)       │
│   - Cursor pattern provides atomic rendering                          │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Python AI CLIs (Aider, Open Interpreter)

┌───────────────────────────────────────────────────────────────────────┐
│  PYTHON AI CLI PROFILES                                               │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   Aider                                                               │
│   ═════                                                               │
│   Framework:    Rich                                                  │
│   Mode:         Cursor pattern only                                   │
│                                                                       │
│   Open Interpreter                                                    │
│   ════════════════                                                    │
│   Framework:    Rich + yaspin                                         │
│   Mode:         Cursor pattern only (dual source)                     │
│                                                                       │
│   Output Pattern (both):                                              │
│   ──────────────────────                                              │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   Rich Live context:                                          │   │
│   │   with Live(renderable):                                      │   │
│   │       cursor hide              <- Live.__enter__()            │   │
│   │       [streaming content]      <- Multiple updates            │   │
│   │       cursor show              <- Live.__exit__()             │   │
│   │                                                               │   │
│   │   yaspin (Open Interpreter):                                  │   │
│   │   with yaspin():                                              │   │
│   │       cursor hide              <- Spinner start               │   │
│   │       [spinner frames]         <- Animation                   │   │
│   │       cursor show              <- Spinner stop                │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   MonoTerm Strategy:                                                  │
│   - Detect cursor pattern for frame boundaries                        │
│   - Works regardless of which library emits the pattern               │
│   - Same pattern, same detection                                      │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Kiro CLI (AWS)

┌────────────────────────────────────────────────────────────────────────┐
│  KIRO CLI PROFILE                                                      │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│   Framework:    Crossterm (Rust)                                       │
│   Mode:         Cursor pattern only (despite BSU/ESU support)          │
│   Detection:    Cursor pattern                                         │
│                                                                        │
│   Key Observation:                                                     │
│   ────────────────                                                     │
│                                                                        │
│   Crossterm library supports BSU/ESU (begin_synchronized_update API).  │
│   Kiro CLI does NOT use this API.                                      │
│   Demonstrates "Support does not equal Usage" principle.               │
│                                                                        │
│   MonoTerm Strategy:                                                   │
│   - Cannot assume BSU/ESU based on Crossterm dependency                │
│   - Must detect actual output                                          │
│   - Cursor pattern detection provides compatibility                    │
│                                                                        │
└────────────────────────────────────────────────────────────────────────┘

Implementation Requirements

┌───────────────────────────────────────────────────────────────────────┐
│  MONOTERM IMPLEMENTATION CHECKLIST                                    │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   Required Detection:                                                 │
│   ───────────────────                                                 │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   [OK] BSU/ESU Mode 2026 detection                            │   │
│   │        Use: Primary frame boundary (if present)               │   │
│   │                                                               │   │
│   │   [OK] DCS format BSU/ESU detection                           │   │
│   │        Use: Alternative encoding (some applications)          │   │
│   │                                                               │   │
│   │   [OK] Cursor hide/show detection                             │   │
│   │        Use: Pseudo-BSU/ESU (universal fallback)               │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   Required Behavior:                                                  │
│   ──────────────────                                                  │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   [OK] Priority handling (BSU/ESU > cursor)                   │   │
│   │   [OK] Data accumulation during frame                         │   │
│   │   [OK] Atomic flush on frame end                              │   │
│   │   [OK] Timeout safety (max wait)                              │   │
│   │   [OK] Pass-through for cursor visibility                     │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
│   NOT Required:                                                       │
│   ─────────────                                                       │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   [--] Modification to any AI CLI                             │   │
│   │   [--] Modification to any TUI framework                      │   │
│   │   [--] Terminal capability negotiation                        │   │
│   │   [--] Configuration per-application                          │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Future Compatibility

┌───────────────────────────────────────────────────────────────────────┐
│  FORWARD COMPATIBILITY ANALYSIS                                       │
├───────────────────────────────────────────────────────────────────────┤
│                                                                       │
│   Why MonoTerm's approach is future-proof:                            │
│                                                                       │
│   ┌───────────────────────────────────────────────────────────────┐   │
│   │                                                               │   │
│   │   1. Framework Coverage                                       │   │
│   │   ─────────────────────                                       │   │
│   │                                                               │   │
│   │   All major TUI frameworks emit cursor pattern:               │   │
│   │   - Ink (TypeScript)        OK                                │   │
│   │   - Rich (Python)           OK                                │   │
│   │   - Textual (Python)        OK                                │   │
│   │   - Ratatui (Rust)          OK                                │   │
│   │   - Crossterm (Rust)        OK                                │   │
│   │   - BubbleTea (Go)          OK                                │   │
│   │   - Charm (Go)              OK                                │   │
│   │                                                               │   │
│   │   Any new AI CLI using these frameworks will be compatible.   │   │
│   │                                                               │   │
│   │   2. Pattern Stability                                        │   │
│   │   ────────────────────                                        │   │
│   │                                                               │   │
│   │   Cursor hide/show (DECTCEM) is VT220 standard from 1983.     │   │
│   │   BSU/ESU (Mode 2026) is gaining adoption.                    │   │
│   │   Both are stable, documented standards.                      │   │
│   │                                                               │   │
│   │   3. No Application Dependencies                              │   │
│   │   ──────────────────────────                                  │   │
│   │                                                               │   │
│   │   Detection is pattern-based, not application-specific.       │   │
│   │   Works with any application emitting these patterns.         │   │
│   │   Future AI CLIs automatically supported.                     │   │
│   │                                                               │   │
│   └───────────────────────────────────────────────────────────────┘   │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

Summary

╔═════════════════════════════════════════════════════════════════════╗
║                                                                     ║
║   MONOTERM COMPATIBILITY MATRIX                                     ║
║                                                                     ║
║   ┌───────────────────────────────────────────────────────────────┐ ║
║   │                                                               │ ║
║   │   Current Coverage:                                           │ ║
║   │   ─────────────────                                           │ ║
║   │   - Claude Code     OK                                        │ ║
║   │   - Gemini CLI      OK                                        │ ║
║   │   - Aider           OK                                        │ ║
║   │   - Open Interpreter OK                                       │ ║
║   │   - Codex CLI       OK                                        │ ║
║   │   - Kiro CLI        OK                                        │ ║
║   │                                                               │ ║
║   │   Total: 6/6 (100%)                                           │ ║
║   │                                                               │ ║
║   │   Detection Method:                                           │ ║
║   │   ─────────────────                                           │ ║
║   │   - BSU/ESU (priority 1): 2/6 CLIs                            │ ║
║   │   - Cursor pattern (priority 2): 6/6 CLIs                     │ ║
║   │                                                               │ ║
║   │   Requirements:                                               │ ║
║   │   ─────────────                                               │ ║
║   │   - MonoTerm changes: Escape sequence detection               │ ║
║   │   - AI CLI changes: NONE                                      │ ║
║   │   - Framework changes: NONE                                   │ ║
║   │                                                               │ ║
║   └───────────────────────────────────────────────────────────────┘ ║
║                                                                     ║
║   Conclusion:                                                       ║
║   MonoTerm's dual detection strategy (BSU/ESU + cursor pattern)     ║
║   provides universal atomic rendering compatibility with all        ║
║   current and future AI CLI applications.                           ║
║                                                                     ║
╚═════════════════════════════════════════════════════════════════════╝

MonoTerm: 100% AI CLI Compatibility

Documentation Index

​Compatibility Matrix

​Compatibility Score

​Detection Method by CLI

​Detailed CLI Profiles

​Claude Code (Anthropic)

​Codex CLI (OpenAI)

​Gemini CLI (Google)

​Python AI CLIs (Aider, Open Interpreter)

​Kiro CLI (AWS)

​Implementation Requirements

​Future Compatibility

​Summary

Compatibility Matrix

Compatibility Score

Detection Method by CLI

Detailed CLI Profiles

Claude Code (Anthropic)

Codex CLI (OpenAI)

Gemini CLI (Google)

Python AI CLIs (Aider, Open Interpreter)

Kiro CLI (AWS)

Implementation Requirements

Future Compatibility

Summary