crynta/terax-ai
GitHub: crynta/terax-ai
一款基于 Tauri 2 和 React 构建的轻量级终端优先的 AI 原生开发工作区,集成了终端、编辑器、版本控制和智能编程助手。
Stars: 8133 | Forks: 864
Terax 是一个基于 Tauri 2 + Rust 和 React 19 构建的轻量级开源终端 (ADE)。具备原生 PTY 后端和 WebGL 渲染器,一个可以使用你自己的密钥或完全本地模型运行的智能 AI 侧边栏,外加内置的代码编辑器、文件浏览器、带有 git graph 的版本控制,以及 Web 预览面板。磁盘占用约 7-8 MB。无遥测。无账号。
## 截图
## 功能
### 终端
- 采用 WebGL 渲染器的 xterm.js,支持多标签页和后台流式传输
- GPU 加速的基于块的终端,提供类似编辑器的命令输入
- 通过 `portable-pty` 实现的原生 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),具备上游感知的推送
- 分支显示,包括分离的 HEAD 状态
- Git 历史面板,带有真实的提交图(合并和分支的泳道渲染)
- 提交搜索和过滤,点击可跳转至远程提交页面
### 文件浏览器
- Catppuccin 图标主题
- 模糊搜索、键盘导航、内联重命名、上下文操作
- 直接将文件和选区附加到 AI 侧边栏
### Web 预览
- 自动检测本地开发服务器,并在预览标签页中打开
- 通过原生子 Webview 预览外部 URL
### 主题与自定义
- 应用内构建自定义主题,可在内置预设和自定义主题之间切换
- 创建自己的主题,分享或从社区导入
- 支持背景图片,可调节透明度和模糊度
- 编辑器主题与应用主题相互独立
### AI
- **BYOK 提供商:** OpenAI, Anthropic, Google (Gemini), Groq, xAI (Grok), Cerebras, OpenRouter, DeepSeek, Mistral,以及任何兼容 OpenAI 的 endpoint
- **本地 / 离线:** LM Studio, MLX, Ollama
- **智能工作流:** 计划,子智能体,通过 `TERAX.md` 实现项目记忆,文件读 / 写 / 编辑 / 多重编辑 / grep / glob,带审批门控的 bash,后台进程
- **Composer:** 通过 `#handle` 插入片段,通过 `@path` 插入文件,斜杠命令,语音输入,从资源管理器或选区附加到智能体
- **自定义智能体**,具有各自的系统提示词和工具子集
- **计划模式**,用于多步骤工作,在执行前生成并确认
## 安装
最新的安装程序可在 [Releases](https://github.com/crynta/terax-ai/releases/latest) 页面获取。Terax 会从那里自动更新。
### Windows 注意事项
- 首次启动时,由于 Terax 尚未进行代码签名,Windows 会显示“Windows 已保护你的电脑”。点击**更多信息**,然后点击**仍要运行**。
- 默认 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。如果没有:`./Terax_*.AppImage --appimage-extract-and-run`。在 Wayland 下如果出现渲染故障,请尝试 `WEBKIT_DISABLE_DMABUF_RENDERER=1`。另外,`.deb` / `.rpm` 包链接到系统 GTK 堆栈,通常运行更流畅。
## 配置 AI
1. 打开 **Settings -> AI**。
2. 选择一个提供商并粘贴你的 API key。对于本地推理,将 Terax 指向你的 LM Studio / MLX / Ollama endpoint。
3. 密钥通过 `keyring` 写入操作系统密钥链。它们绝不会触及磁盘或 localStorage。
## 从源码构建
**前置条件**
- Rust (stable), https://rustup.rs
- Node 20+ 和 [pnpm](https://pnpm.io)
- 你的平台所需的 Tauri 前置条件, https://tauri.app/start/prerequisites/
**运行**
```
pnpm install
pnpm tauri dev # development
pnpm tauri build # production bundle
```
**检查**
```
pnpm exec tsc --noEmit # frontend type-check
cd src-tauri && cargo clippy --all-targets --locked -D warnings # Rust lint (matches CI)
cd src-tauri && cargo test --locked # Rust tests
```
## 技术栈
Tauri 2, Rust, `portable-pty`, React 19, TypeScript, Vite, xterm.js, CodeMirror 6, Vercel AI SDK v6, Tailwind v4, shadcn/ui, Zustand.
## 许可证
Terax 采用 Apache-2.0 许可证。有关我们依赖项的更多信息,请参阅 [Apache License 2.0](LICENSE)。
## Star 历史
![]() Multi-tab terminal with WebGL rendering |
![]() Custom themes, presets, and background images |
![]() Web preview of local dev servers |
![]() Source control panel with git graph in history |
![]() Agentic AI workflow with edit diffs in the code editor |
|
标签:AI编程助手, React, Rust, SOC Prime, Syscalls, Tauri, 可视化界面, 开发工具, 终端模拟器, 网络流量审计, 自动化攻击




