terax-ai

Terax

轻量级、终端优先的 AI 原生开发工作区。

官网 · 文档 · 网站源码

---

Terax 是一个轻量级的开源终端（ADE），基于 Tauri 2 + Rust 和 React 19 构建。它拥有原生 PTY 后端和 WebGL 渲染器、一个支持自有 API Key 或完全本地模型的 agentic AI（智能体 AI）侧边栏，以及内置的代码编辑器、文件浏览器、带 Git 图谱的源码控制面板和 Web 预览面板。磁盘占用约 7-8 MB。无遥测。无需账户。

截图

多标签终端，支持 WebGL 渲染	自定义主题、预设和背景图片
本地开发服务器的 Web 预览	源码控制面板，历史记录中带有 Git 图谱
agentic AI 工作流，代码编辑器中显示编辑差异

功能

终端

• xterm.js（带 WebGL 渲染器），多标签，后台流式传输
• 基于 GPU 加速的块状终端，拥有类似编辑器的命令输入
• 原生 PTY 后端，通过 portable-pty 实现（支持 zsh, bash, pwsh, fish, cmd）
• 分屏面板（水平和垂直）
• 内联搜索、链接检测、真彩色支持
• Windows 上支持每个标签页独立配置工作区环境（本地或任意已安装的 WSL 发行版）

代码编辑器

• CodeMirror 6（支持所有主流语言：TS/JS, Rust, Python, Go, C/C++, Java, HTML/CSS, JSON, Markdown 等）
• 内联 AI 自动补全，支持本地模型
• AI 编辑差异，逐块接受或拒绝
• Vim 模式
• 内置十种编辑器主题：Atom One, Aura, Copilot, GitHub Dark / Light, Gruvbox Dark, Nord, Tokyo Night, Xcode Dark / Light

源码控制

• 暂存/取消暂存代码块、提交（Cmd+Enter / Ctrl+Enter）、推送（自动感知上游）
• 分支显示，包括 detached HEAD 状态
• Git 历史面板，带有真实的提交图（合并和分支的车道渲染）
• 提交搜索与过滤，点击可跳转到远程提交页面

文件浏览器

• Catppuccin 图标主题
• 模糊搜索、键盘导航、内联重命名、右键菜单操作
• 将文件和选中内容直接附加到 AI 侧边栏

Web 预览

• 自动检测本地开发服务器并在预览标签页中打开
• 通过原生子 Webview 预览外部 URL

主题与自定义

• 应用内构建自定义主题，可在内置预设和自有主题间切换
• 创建自己的主题、分享或从社区导入
• 支持背景图片，可调节透明度和模糊度
• 编辑器主题与应用主题独立

AI

• BYOK（自带密钥）提供商： OpenAI, Anthropic, Google (Gemini), Groq, xAI (Grok), Cerebras, OpenRouter, DeepSeek, Mistral，以及任意兼容 OpenAI 的端点
• 本地/离线： LM Studio, MLX, Ollama
• Agentic 工作流： 规划、子智能体、通过 TERAX.md 实现项目记忆、文件读/写/编辑/多编辑/grep/glob、带审批门的 bash 命令、后台进程
• Composer（创作器）： 通过 #handle 使用片段、通过 @path 引用文件、斜杠命令、语音输入、从浏览器或选择区域附加到智能体
• 自定义智能体：拥有独立的系统提示词和工具子集
• 计划模式：用于多步骤工作，先生成计划再确认执行

安装

最新安装程序位于发布页面。Terax 会从那里自动更新。

Windows 注意事项

• 首次启动时，Windows 会显示“Windows 已保护你的电脑”，因为 Terax 尚未进行代码签名。点击更多信息，然后选择仍要运行。
• 默认 shell 检测顺序：pwsh.exe (PowerShell 7+) -> powershell.exe (Windows PowerShell 5.1) -> cmd.exe。
• WSL 是一等公民的工作区环境，而非被包装的子进程。

Linux 注意事项

• Arch / AUR： yay -S terax-bin（或 paru 等）。追踪最新发布版本。
• NixOS / Nix： 使用官方 flake —— nix profile install github:crynta/terax-ai（非 NixOS），或导入 flake 并将 inputs.terax.packages.${pkgs.system}.terax 添加到 environment.systemPackages（NixOS）。也可使用 nixosModules.terax 输出以获得更简单的配置。
• AppImage： 需要 FUSE。如果没有 FUSE：./Terax_*.AppImage --appimage-extract-and-run。在 Wayland 下遇到渲染问题，可尝试 WEBKIT_DISABLE_DMABUF_RENDERER=1。否则，.deb / .rpm 包链接到系统 GTK 栈，通常更流畅。

配置 AI

1. 打开 设置 -> AI。
2. 选择一个提供商并粘贴你的 API Key。对于本地推理，将 Terax 指向你的 LM Studio / MLX / Ollama 端点。
3. Key 通过 keyring 写入操作系统密钥链。绝不会写入磁盘或 localStorage。

从源码构建

前置条件

• Rust (稳定版)，https://rustup.rs
• Node 20+ 和 pnpm
• 对应平台的 Tauri 前置条件，https://tauri.app/start/prerequisites/

运行

pnpm install
pnpm tauri dev          # 开发模式
pnpm tauri build        # 生产构建

检查

pnpm exec tsc --noEmit                                            # 前端类型检查
cd src-tauri && cargo clippy --all-targets --locked -D warnings   # Rust 代码检查（与 CI 一致）
cd src-tauri && cargo test --locked                               # Rust 测试

技术栈

Tauri 2, Rust, portable-pty, React 19, TypeScript, Vite, xterm.js, CodeMirror 6, Vercel AI SDK v6, Tailwind v4, shadcn/ui, Zustand。

贡献

欢迎提交 Issue 和 Pull Request！请随时提出问题、建议功能或提交合并请求。更多详情请参见 CONTRIBUTING.md。

许可证

Terax 采用 Apache-2.0 许可证。有关我们依赖项的信息，请参见 Apache License 2.0。

Star 历史