Terax：终端优先的 AI 开发环境

项目简介

Terax 是一个轻量、开源的终端优先 AI 原生开发环境（ADE），基于 Tauri 2 + Rust 与 React 19 构建。它自带原生 PTY 后端与 GPU 渲染终端，并提供可对接自有 API Key 或完全本地模型的 AI 侧边面板，同时集成代码编辑器、文件浏览器、源代码管理和网页预览。安装体积约 7-8 MB，无遥测、无需账号。

主要功能

终端

• 基于 portable-pty 的原生 PTY 后端，支持 zsh、bash、pwsh、fish、cmd
• 多标签与后台流式输出，水平 / 垂直分屏，内联搜索、链接识别、真彩色
• 支持把资源管理器或桌面上的文件拖入终端，自动转为安全引用的路径
• Windows 上可按标签选择本地或任意已安装的 WSL 发行版作为工作区环境
• Spaces 可在多次启动之间恢复标签、工作目录与分屏布局

代码编辑器

• CodeMirror 6，支持 TS/JS、Rust、Python、Go、C/C++、Java、HTML/CSS、JSON、Markdown 等语言
• 内联 AI 补全（支持本地模型），AI 编辑以 diff 形式逐块接受或拒绝
• 可选的语言服务器支持：诊断、跳转、补全、格式化，也可接入自定义服务器
• Markdown 渲染，以及图片、视频、音频、PDF 查看；支持 Vim 模式
• 内置 Kanagawa、Catppuccin、Rosé Pine、Everforest、Dracula、Solarized、Nord、Tokyo Night、GitHub、Xcode 等主题

源代码管理

• 按 hunk 暂存 / 取消暂存，提交（Cmd+Enter / Ctrl+Enter），推送时感知 upstream
• 显示分支状态（含 detached HEAD）
• Git 历史面板带真实提交图（合并与分支的分道渲染），支持提交搜索与跳转到远端提交页

文件浏览器

• Catppuccin 图标主题、模糊搜索、键盘导航、内联重命名、右键操作
• 磁盘文件变化时实时更新，可把文件与选中内容直接附加给 AI 侧边面板

网页预览

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

AI

• BYOK 服务商： OpenAI、Anthropic、Google（Gemini）、Groq、xAI（Grok）、Cerebras、OpenRouter、DeepSeek、Mistral，以及任意 OpenAI 兼容端点
• 本地 / 离线： LM Studio、MLX、Ollama
• 智能体工作流： 计划、子智能体、通过 TERAX.md 维护项目记忆，文件读 / 写 / 编辑 / 多重编辑 / grep / glob，bash 执行需要审批，支持后台进程
• 编码智能体编排： 在终端中启动 Claude Code，查看其输出，并通过需审批的工具派发后续任务
• Composer： 用 #handle 插入提示片段、用 @path 引用文件，支持语音输入
• 支持自定义智能体（自带系统提示词与工具子集）与多步任务的 Plan 模式

安装与使用

最新安装包发布在 Releases 页面，Terax 会从该页面自动更新。

Linux 发行版相关安装方式：

# Arch / AUR
yay -S terax-bin

# NixOS / Nix（非 NixOS）
nix profile install github:crynta/terax-ai

NixOS 用户可以导入 flake，并把 inputs.terax.packages.${pkgs.system}.terax 加入 environment.systemPackages；也可使用 nixosModules.terax。

配置 AI

1. 打开 Settings -> AI。
2. 选择服务商并粘贴 API Key；使用本地推理时，把 Terax 指向你的 LM Studio / MLX / Ollama 端点。
3. Key 通过 keyring 写入操作系统钥匙串，不落磁盘、不写入 localStorage。

从源码构建

需要 Rust（stable）、Node 22+ 与 pnpm，以及对应平台的 Tauri 依赖。

pnpm install
pnpm tauri dev          # 开发
pnpm tauri build        # 生产打包

注意事项

• Windows： 默认 shell 探测顺序为 pwsh.exe -> powershell.exe -> cmd.exe；WSL 是原生工作区环境，而不是包装过的子进程。
• AppImage： 依赖 FUSE，缺失时可运行 ./Terax_*.AppImage --appimage-extract-and-run；Wayland 下出现渲染异常可尝试 WEBKIT_DISABLE_DMABUF_RENDERER=1，或改用链接系统 GTK 的 .deb / .rpm 包。
• Windows 安装时若系统缺少 WebView2，需要联网安装该运行时。
• 项目采用 Apache-2.0 许可证。

---

本作品整理自 GitHub 开源项目 crynta/terax-ai，原作者 @crynta，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。