Terax: A 7 MB Open‑Source Tauri2+Rust IDE that Unifies Terminal, Editor, Git, and AI Agent Offline

Developers often suffer from context‑switching between VSCode, iTerm2, Git clients, and AI chat windows, experience sluggish Electron‑based AI terminals that consume hundreds of megabytes, worry about telemetry and insecure handling of API keys, and face performance issues on low‑end machines.

Terax Overview

Terax (7.4k GitHub stars) is an open‑source, Tauri2 + Rust application packaged at only 7 MB. It integrates a multi‑tab terminal, CodeMirror6 editor, file manager, Git visualisation panel, web preview, and an AI Agent sidebar into a single window. It requires no account, collects no telemetry, and stores API keys in the system keychain.

Core Architecture

Backend: Rust + Tauri2, using native WebView instead of Chromium, and a portable‑pty backend for terminal rendering.

Integration: Single‑window layout with multi‑tab terminal, CodeMirror6 editor, file manager, Git visual panel, web preview, and AI Agent.

Privacy: No registration, zero telemetry, encrypted key storage.

AI Modes: Connect to cloud APIs (OpenAI, Claude, Gemini, etc.) or use local models via LM Studio/Ollama.

License: Apache‑2.0, unlimited commercial use.

Six Core Modules

Native High‑Performance Terminal: Uses portable-pty and xterm.js WebGL rendering; supports multi‑tab, split layout, 50 000‑line buffer, colour, and WSL detection.

CodeMirror6 Editor: Lightweight, Vim‑mode friendly, supports TS/JS/Python/Rust/HTML/CSS/Go/C/C++/Java/C#/JSON/Markdown, with independent theming and 15 preset themes.

Git Visual Panel: Calls the system Git CLI (no libgit2), shows a full commit graph, keyword search, one‑click commit (Cmd+Enter), and detached‑HEAD highlighting.

AI Agent: A controllable agent with file‑read permission auto‑allow, write/delete/command actions require manual approval, and it blocks access to sensitive files such as .env and .ssh.

Project Memory (TERAX.md): A local Markdown file that the AI reads on startup to provide project‑wide context; changes are tracked via Git diff.

File Manager + Web Preview: Fuzzy file search, inline rename, and a local dev server that opens a web preview pane (basic URL preview only).

Why Only 7 MB?

Discarded Chromium; adopted Tauri2 where Rust handles PTY, file I/O, Git, key management, and network requests, while the React front‑end communicates via IPC.

Lightweight component choices: CodeMirror6 and xterm.js WebGL avoid heavy dependencies.

Lean compilation: No libgit2, reuse system Git CLI; unused features are omitted from the binary.

Installation

Download the official installer from GitHub:

macOS: .dmg Linux: .AppImage, .deb, .rpm (AUR: yay -S terax-bin)

Windows: .exe (first launch may trigger SmartScreen; choose “Run anyway”).

To build from source (Rust + Node environment):

pnpm install</code>
<code>pnpm tauri dev    # local development</code>
<code>pnpm tauri build  # generate installer</code>
<code>pnpm exec tsc --noEmit   # front‑end type check</code>
<code>cd src-tauri && cargo clippy   # Rust lint

AI Model Configuration

Open Settings → AI panel.

Select a provider:

Cloud API: enter the platform key; the key is stored encrypted in the system keychain.

Local offline: provide LM Studio or Ollama endpoint; no API key needed.

Optional: customise system prompts, enable Plan mode, configure sub‑agent permissions.

Known Limitations

No built‑in LSP; suitable for small scripts and config files but not for large TS/Java projects.

Does not support tmux/screen session persistence.

No plugin/extension ecosystem yet; features depend on official releases.

Web preview cannot open DevTools for debugging.

Windows binaries lack code signing, causing initial security prompts.

Full WSL support arrived in version 0.6.3; earlier versions may mis‑detect directories.

AI cannot read .env or .ssh unless manually whitelisted.

TERAX.md should stay under a few pages; overly long content exceeds the local model context.

Side‑by‑Side Comparison with Mainstream Tools

Installation Size: Terax 7 MB vs. Warp 200 MB+, Cursor 400 MB+, iTerm2 50 MB.

Architecture: Terax Tauri2 + Rust; Warp Rust + Electron; Cursor Electron; iTerm2 native macOS.

Cross‑Platform: Terax Win/macOS/Linux; Warp all platforms; Cursor all platforms; iTerm2 macOS only.

AI Integration: Terax controlled Agent with diff approval; Warp single‑line AI commands; Cursor full‑editor AI; iTerm2 none.

Offline Model Support: Terax supports Ollama/LM Studio; Warp none; Cursor only official cloud models; iTerm2 local plugins only.

Telemetry: Terax none; Warp enabled by default (can be disabled); Cursor uploads code to server; iTerm2 none.

Git Visualisation: Terax full commit graph; Warp basic panel; Cursor basic operations; iTerm2 none.

Unified Window: Terax terminal + editor + Git + web preview; Warp terminal only; Cursor editor only; iTerm2 terminal only.

Key Storage: Terax system keychain encryption; Warp local plaintext risk; Cursor cloud upload; iTerm2 local storage.

License: Terax Apache‑2.0; Warp closed‑source commercial; Cursor closed‑source (free/paid); iTerm2 open‑source.

Source Repository

https://github.com/crynta/terax-ai