CX Terminal

The AI-Native Terminal for CX Linux
Agentic system administration, real-time context awareness, and seamless AI orchestration.

Features • Quick Start • Architecture • Safety • Contributing

---

What is CX Terminal?

CX Terminal is not just a terminal emulator; it is the primary interface for CX Linux. It integrates a specialized AI side-panel that shares a "nervous system" with your OS via a dedicated IPC daemon. It understands your intent, captures your voice, and learns from your unique workflow.

# Real-time AI intervention (Ctrl+Space)
cx ask "Why is my build failing?"

# Agentic command execution
cx ask --do "Optimize my NVIDIA drivers for training"

# Voice-to-Command
# [Capture Audio] -> "Create a new git branch for the audio feature"

---

🚀 Key Features

Feature	Description
AI Side-Panel	Integrated LLM panel (Ctrl+Space) with full terminal context.
Audio Intelligence	Native voice capture via cpal for hands-free operations.
Daemon IPC	Secure Unix socket communication for OS-level agentic tasks.
ML Workflow Learning	Local TF-IDF and N-gram models that learn your command patterns.
Command Blocks	Visual output grouping with interactive AI diagnosis for errors.
Hardware-Aware	Optimized for Mac Studio (M2/M3) and NVIDIA/AMD GPU environments.

---

🛠️ Quick Start

Prerequisites

• OS: CX Linux / Ubuntu 22.04+ / macOS (M-Series)
• Rust: 1.75+ (Stable)
• Daemon: cx-daemon must be running for agentic features.

Installation

# 1. Clone the repository
git clone https://github.com/cxlinux-ai/cx.git
cd cx

# 2. Build the terminal
cargo build --release

# 3. Launch the AI-Native experience
./target/release/cx-terminal-gui

---

🏗️ Architecture

CX Terminal uses a distributed architecture to ensure low latency and high security:

• Frontend: GPU-accelerated terminal core (based on WezTerm).
• AI Panel: Custom Rust-based UI for LLM orchestration.
• Daemon (cx-daemon): A background service handling privileged OS tasks.
• IPC Layer: 4-byte length-prefixed JSON-RPC over Unix sockets.

---

🛡️ Safety & Security

• Sandboxed Execution: AI-generated commands run in isolated environments.
• Dry-Run Validation: View AI plans before they touch your system.
• Local-First ML: Your command history and learning models never leave your machine.
• Audit Logging: Full SQLite-backed history in ~/.cx/history.db.

---

🤝 Contributing

We offer a Bounty Program for merged PRs:

• Small (): Bug fixes, UI tweaks.
• Medium (): New AI tool integrations, performance gains.
• Large (+): Major architectural improvements.

---

_{Built with love by the CX Linux team.}