crynta/terax-ai

GitHub: crynta/terax-ai

一款基于 Tauri 2 和 React 构建的轻量级终端优先的 AI 原生开发工作区,集成了终端、编辑器、版本控制和智能编程助手。

Stars: 8133 | Forks: 864

Terax

Terax

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

version downloads platform Discord

官网 · 文档 · 网站源码

Terax 是一个基于 Tauri 2 + Rust 和 React 19 构建的轻量级开源终端 (ADE)。具备原生 PTY 后端和 WebGL 渲染器,一个可以使用你自己的密钥或完全本地模型运行的智能 AI 侧边栏,外加内置的代码编辑器、文件浏览器、带有 git graph 的版本控制,以及 Web 预览面板。磁盘占用约 7-8 MB。无遥测。无账号。 ## 截图
Terminal
Multi-tab terminal with WebGL rendering
Themes and background image
Custom themes, presets, and background images
Web preview
Web preview of local dev servers
Source control and git graph
Source control panel with git graph in history
AI window
Agentic AI workflow with edit diffs in the code editor
## 功能 ### 终端 - 采用 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 历史
Star History Chart
标签:AI编程助手, React, Rust, SOC Prime, Syscalls, Tauri, 可视化界面, 开发工具, 终端模拟器, 网络流量审计, 自动化攻击