terax-ai 是什么?

Terax 是一个约 7MB 的开源跨平台 AI 原生终端(ADE),用 Tauri 2 + Rust + React 19 构建:原生 PTY 后端配现代 UI——多标签终端(xterm.js + WebGL)、集成代码编辑器(CodeMirror 6)、文件浏览器和一等 AI 侧边栏,AI 用你自己的 API key(OpenAI/Anthropic/Google/Groq/xAI/Cerebras 或 OpenAI 兼容)或经 LM Studio 跑本地模型,无遥测、key 存 OS 钥匙串。

⭐ 5,227 Stars 🍴 556 Forks TypeScript Apache-2.0 作者: crynta
来源:README 首段 + Features + Tech stack 查看 GitHub 仓库 →

为什么值得关注

AI 终端这条赛道有 Warp、Wave 等,但多偏重、要账号或带遥测。Terax 的差异化是「轻 + 开源 + BYOK + 本地模型」:整个 app 仅 ~7MB(Tauri 而非 Electron),无遥测、不要账号、API key 存 OS 钥匙串而非落盘或 localStorage。它不只是终端,而是把多标签终端(xterm.js + WebGL 渲染、portable-pty 原生后端)、CodeMirror 6 代码编辑器(含 AI 内联补全和编辑 diff、Vim 模式、多套主题)、文件浏览器、本地 dev server 自动预览、以及功能完整的 AI 侧边栏(多 provider + LM Studio 本地、语音输入、多 agent/子 agent、tasks/plans、带审批流的文件读写工具、TERAX.md 项目记忆)整合进一个轻量原生应用。跨 macOS/Linux/Windows,AUR/AppImage/deb/rpm 齐全。在「轻量 AI 原生终端」这个细分上是完成度高、隐私友好的开源实现。

来源:README 首段 / Features / Quality

核心功能

多标签终端(xterm.js + WebGL + 原生 PTY)

xterm.js + WebGL 渲染器、多标签且后台流式(切走的标签继续输出),原生 PTY 后端经 portable-pty 支持 zsh/bash/pwsh 等;shell 集成(注入 init 脚本上报 cwd、prompt marker),内联搜索、链接检测、true-color。

来源:README Features 'Terminal'
集成代码编辑器(CodeMirror 6 + AI)

CodeMirror 6 编辑器支持 TS/JS、Rust、Python、HTML/CSS、JSON、Markdown;带 AI 内联补全和 AI 编辑 diff(在编辑器里看 AI 改了什么)、Vim 模式、多套预置主题(Tokyo Night/Nord/GitHub/Atom One/Aura/Copilot/Xcode)。终端 + 编辑器同体,省去切应用。

来源:README Features 'Editor'
BYOK AI 侧边栏 + 本地模型

AI 用自己的 key:OpenAI/Anthropic/Google/Groq/xAI/Cerebras 及任意 OpenAI 兼容;也可经 LM Studio 跑本地/离线模型。能力含语音输入、编辑 diff、多 agent 与子 agent、snippets/skills、可定制 system prompt、TERAX.md 项目记忆与配置、tasks/plans/search/文件读写工具且带审批流(approval flow)。

来源:README Features 'AI (BYOK)'
文件浏览器 + 本地 dev server 预览

文件浏览器用 Catppuccin 图标主题(Material Icon Theme resolver)、模糊搜索、键盘导航、内联重命名、右键操作;Web Preview 自动检测本地 dev server 并在预览标签打开——前端开发时终端、编辑器、预览一体。

来源:README Features 'File Explorer' / 'Web Preview'
轻量 + 隐私优先

整个 bundle ~7MB(Tauri 而非 Electron 是关键),快;API key 经 keyring 存 OS 钥匙串、绝不落盘或进 localStorage;无遥测、不要账号。对在意体积和隐私的用户是真卖点。

来源:README Features 'Quality' / Configure AI
跨平台 + 多渠道分发

macOS / Linux / Windows 全支持;Windows 默认 shell 按 pwsh→powershell→cmd 顺序检测(未签名首次有 SmartScreen 提示);Linux 走 AUR(yay -S terax-bin)/ AppImage(需 FUSE)/ .deb / .rpm。可从源码 pnpm tauri dev/build 构建。

来源:README Windows/Linux notes / Build from source

技术架构

Terax 是典型的 Tauri 2 桌面应用:src-tauri/(118 文件,Rust)是原生后端——portable-pty 起 PTY、keyring 存密钥、Tauri 提供窗口与系统集成;src/(282 文件,React 19 + TypeScript)是前端 UI——xterm.js + WebGL 做终端渲染、CodeMirror 6 做编辑器、shadcn/ui + Tailwind v4 做组件、Zustand 管状态、Vercel AI SDK v6 接各 LLM provider。这种「Rust 原生后端 + Web 前端」的 Tauri 组合让 app 只有 ~7MB(对比 Electron 动辄上百 MB),是「轻量」卖点的根本。AI 侧边栏经 Vercel AI SDK 统一接 OpenAI/Anthropic/Google/Groq/xAI/Cerebras/OpenAI 兼容 + LM Studio 本地,工具调用(文件读写/search/tasks)走 approval flow,TERAX.md 做项目记忆。设计判断:把终端 + 编辑器 + 文件浏览器 + AI 侧边栏整合进一个 Tauri 轻量应用、BYOK + 本地模型 + 无遥测 + key 进钥匙串,是对 Warp/Electron 类重型 AI 终端的清晰差异化——用 Tauri 的体积优势 + 隐私优先打动在意这两点的用户;代价是 Tauri 的 WebView 在不同平台(尤其 Linux Wayland)渲染一致性需要额外处理(README 已列 WEBKIT_DISABLE_DMABUF_RENDERER 等 workaround),且功能广(终端+编辑器+AI+预览)意味着维护面大。

来源:tree(src/src-tauri)+ README Tech stack / notes

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) portable-pty — 原生 PTY 后端(zsh/bash/pwsh)portable-pty xterm.js + WebGL — 终端渲染xterm.js + Web… CodeMirror 6 — 代码编辑器(多语言 + Vim)CodeMirror 6 Vercel AI SDK v6 — 统一接多 LLM providerVercel AI SDK… keyring(Rust)— API key 存 OS 钥匙串keyring(Rust… 多标签终端(xterm.js + WebGL + 原生 PTY)多标签终端(xterm.js… 集成代码编辑器(CodeMirror 6 + AI)集成代码编辑器(CodeM… BYOK AI 侧边栏 + 本地模型BYOK AI 侧边栏 + 本… 文件浏览器 + 本地 dev server 预览文件浏览器 + 本地 dev… 轻量 + 隐私优先 跨平台 + 多渠道分发 terax-ai 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript(React 前端)+ Rust(Tauri 后端)框架Tauri 2 + React 19;xterm.js(终端)+ CodeMirror 6(编辑器)+ shadcn/ui + Tailwind v4 + Zustand
portable-ptyxterm.js + WebGLCodeMirror 6Vercel AI SDK v6keyring(Rust)— API key 存 OS 钥匙串LM Studio
Tauri 2 桌面应用,~7MB bundle;跨 macOS/Linux/Windows;分发 AUR(terax-bin)/AppImage/.deb/.rpm + GitHub Releases;从源码 pnpm tauri dev/build;无遥测、不要账号、key 进 OS 钥匙串;Apache-2.0;Windows 未签名有 SmartScreen 提示
来源:README Tech stack + Build from source + tree

快速上手

# 下载安装包(GitHub Releases,或各平台包管理器) # macOS / Windows:从 Releases 下载(Windows 未签名首次 SmartScreen→More info→Run anyway) # Linux Arch/AUR: yay -S terax-bin # Linux AppImage(需 FUSE;无 FUSE 用 --appimage-extract-and-run);或用 .deb / .rpm # 配置 AI(BYOK) # Settings → AI → 选 provider 粘贴 API key;本地推理指向 LM Studio endpoint # key 经 keyring 写入 OS 钥匙串,不落盘 # 从源码构建 # 前置:Rust stable + Node 20+ + pnpm + Tauri 平台依赖 pnpm install pnpm tauri dev # 开发 pnpm tauri build # 生产包 # 检查:pnpm exec tsc --noEmit;cd src-tauri && cargo clippy # 项目记忆/配置写在 TERAX.md
来源:README Windows/Linux notes / Configure AI / Build from source 原文

使用场景

1. 想要轻量 AI 终端的开发者:受够 Electron 类重型 AI 终端,要一个 ~7MB、快、无遥测、不要账号的替代;2. BYOK / 隐私优先:用自己的多家 API key(key 存钥匙串),或经 LM Studio 完全本地跑,代码与密钥不外流;3. 终端 + 编辑 + AI 一体工作流:在一个应用里多标签终端、CodeMirror 编辑、AI 侧边栏改代码看 diff、本地 dev server 自动预览,省去多应用切换;4. 跨平台统一体验:macOS/Linux/Windows 用同一个终端;5. agent 化操作:用多 agent/子 agent + 带审批流的文件/search 工具让 AI 在终端里干活,TERAX.md 提供项目记忆。

来源:README Features / Quality

优势与局限

优势

  • 体积极小:~7MB bundle(Tauri 而非 Electron),相比动辄上百 MB 的同类是数量级差异,启动快、占用低
  • 隐私优先且 BYOK:无遥测、不要账号、API key 经 keyring 存 OS 钥匙串不落盘;多 provider + LM Studio 本地模型,数据可不外流
  • 功能整合度高:终端(xterm.js+WebGL+原生 PTY)+ CodeMirror 6 编辑器(AI 补全/diff/Vim)+ 文件浏览器 + 本地 dev server 预览 + 完整 AI 侧边栏,一个应用搞定
  • AI 能力完整:多 agent/子 agent、语音输入、编辑 diff、tasks/plans、带审批流的文件读写/search 工具、TERAX.md 项目记忆、可定制 system prompt
  • 技术栈现代且跨平台:Tauri 2 + Rust + React 19 + Vercel AI SDK v6 + Tailwind v4 + shadcn/ui,macOS/Linux/Windows + AUR/AppImage/deb/rpm 多渠道分发

局限

  • 稳定性 / 成熟度:仍是 0.7.x(v0.7.1),几天一版,功能广(终端+编辑器+AI+预览)意味着回归面大、可能有未打磨的边角;Windows 未签名有 SmartScreen 提示(作者称暂无证书)
  • Tauri WebView 平台一致性:Tauri 用系统 WebView,Linux Wayland 有渲染 glitch 需 workaround(WEBKIT_DISABLE_DMABUF_RENDERER 等),跨平台渲染一致性不如 Electron 自带 Chromium 省心
  • 可测试性 / 质量未量化:AI 终端的实际体验(补全质量、agent 干活成功率)依赖所选 provider 与模型,README 无 benchmark;编辑器/终端的稳定性需实测
  • 可维护性 / 复杂度:终端 + 编辑器 + 文件浏览器 + AI + 预览五大块整合,Rust + TS 双栈,src 282 + src-tauri 118 文件,功能面广维护成本高
  • 依赖外部 API:AI 能力靠 BYOK 的各 provider(或本地 LM Studio),agent 本身不含模型,能力与成本由所选 provider 决定;本地模型质量受 LM Studio 所跑模型限制
  • 生态/插件:作为相对新的终端,主题/集成是预置的,深度自定义(自写主题、插件扩展)能力未在材料中体现,扩展性边界待观察
来源:综合 README + tree + Tauri 特性

最新版本

v0.7.1(2026-05-21)。最近 3 个 release:v0.6.6 (2026-05-16) → v0.7.0 (2026-05-20) → v0.7.1 (2026-05-21),几天一版的活跃节奏。仓库 2026-04-21 创建,仍处 0.7.x 早期。AUR(terax-bin) 跟踪最新 release。

来源:GitHub Releases API(3 个 tag)

总结评价

如果你想要一个轻量、隐私优先、BYOK 的 AI 终端,Terax 是当前开源里很对路的选择:~7MB Tauri 应用,终端 + CodeMirror 编辑器 + 文件浏览器 + AI 侧边栏一体,多 provider + LM Studio 本地、无遥测、key 进钥匙串。务实建议:1) 它最大卖点是「轻 + 隐私 + BYOK」,如果你受够 Electron 类重型 AI 终端、或要本地模型/不外流,很合适;2) 设好你的 provider key(或指 LM Studio)即用,key 存钥匙串不落盘这点对安全友好;3) 0.7.x 早期、几天一版,功能广可能有边角未打磨,重度依赖前先试关键工作流;4) Linux Wayland 用户注意渲染 workaround,Windows 未签名首次要点 Run anyway;5) AI 体验取决于你选的 provider/模型,先用熟悉的 provider 试补全和 agent 干活质量;6) 想要稳定就跟 release tag,AUR 用户走 terax-bin。

来源:综合分析
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 10:51. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件