terax-ai README

The project's README from github.com/crynta/terax-ai. As one markdown file: README.md.

Terax

Terax

Lightweight Terminal-first AI-native dev workspace.

Website · Docs · Website's source code

version downloads platform Discord YouTube

简体中文 | Español | Deutsch | Français | 日本語 | 한국어 | Português | Polski | Русский | Bahasa Indonesia | हिन्दी


Terax is a lightweight open-source terminal-first AI-native development environment (ADE) built on Tauri 2 + Rust and React 19. A native PTY backend with a WebGL renderer, an agentic AI side-panel that runs against your own keys or fully local models, plus a code editor, file explorer, source control with a git graph, and a web preview pane built in. About 7-8 MB on disk. No telemetry. No account.

Screenshots

Web preview
Web preview of local dev servers
AI window
Agentic AI workflow with edit diffs in the code editor
Themes and background image
Custom themes, presets, and background images
Source control and git graph
Source control panel with git graph in history
Terminal
Block-based WebGL terminal with editor-like input panel

Features

Terminal

Code editor

Source control

File explorer

Web preview

Themes and customization

AI

Install

Latest installers are on the Releases page. Terax auto-updates from there.

Windows notes

Linux notes

Configure AI

  1. Open Settings -> AI.
  2. Pick a provider and paste your API key. For local inference, point Terax at your LM Studio / MLX / Ollama endpoint.
  3. Keys are written to the OS keychain via keyring. They never touch disk or localStorage.

Build from source

Prerequisites

Run

pnpm install
pnpm tauri dev          # development
pnpm tauri build        # production bundle

Checks

pnpm lint
pnpm check-types
pnpm test
cd src-tauri && cargo clippy --all-targets --locked -- -D warnings   # Rust lint (matches CI)
cd src-tauri && cargo nextest run --locked                           # or: cargo test --locked

Tech stack

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

Contributing

Issues and PRs are welcome! Feel free to open issues, suggest features, or submit pull requests. See CONTRIBUTING.md and the architecture docs for more details.

Code signing

SignPath

Windows builds are signed with a free code signing certificate provided by SignPath.io, certificate by the SignPath Foundation.


License

Terax is licensed under the Apache-2.0 License. For more information on our dependencies, see Apache License 2.0.

terax-ai (crynta/terax-ai)

Searching Database…

Что это такое?Terax — это лёгкая open-source среда разработки с терминалом во главе угла и встроенным ИИ, построенная на Tauri 2, Rust и React 19 — занимает на диске около 7-8 МБ, без телеметрии и без аккаунта.
Так это просто эмулятор терминала или полноценная среда разработки?Полноценное десктопное приложение: внутри — терминал с GPU-ускорением, редактор кода, файловый менеджер, контроль версий с графом git, панель предпросмотра веб-страниц и, поверх всего этого, боковая панель с ИИ-агентом.
Где её взять — установщик, пакетный менеджер или сборка из исходников?Скачайте установщик со страницы Releases; оттуда приложение обновляется автоматически. На Arch используйте yay -S terax-bin, на Nix — nix profile install github:crynta/terax-ai, также доступны пакеты .deb/.rpm/AppImage. Для сборки из исходников нужны Rust, Node 20+ с pnpm и зависимости Tauri.
Мне нужны свои API-ключи для ИИ или он может работать полностью локально?Работает по схеме «принеси свой ключ»: OpenAI, Anthropic, Gemini, Groq, xAI, Cerebras, OpenRouter, DeepSeek, Mistral или любой endpoint, совместимый с OpenAI, — либо подключите LM Studio, MLX или Ollama, чтобы использовать полностью локальные офлайн-модели.
Есть ли подводные камни при установке на Linux?Для AppImage нужен FUSE — без него запускайте ./Terax.AppImage --appimage-extract-and-run. На Wayland артефакты отрисовки обходятся переменной WEBKITDISABLEDMABUFRENDERER=1, а сборки .deb/.rpm обычно работают стабильнее.
Она отправляет куда-то мой код или мои API-ключи?Никакой телеметрии, аккаунт не требуется. API-ключи сохраняются в системное хранилище ключей (keychain) через keyring и никогда не попадают на диск или в localStorage, а локальные модели позволяют работать полностью офлайн.
Что ИИ-агент реально умеет делать в моём проекте?Он планирует многошаговую работу, запускает суб-агентов, хранит память проекта в файле TERAX.md, а также получает инструменты для чтения/записи/редактирования файлов (в том числе мультиредактирование), grep/glob и bash с подтверждением действий. В режиме Plan сначала генерируется и подтверждается план, и только потом что-то делается.
Может ли она управлять внешними кодинг-агентами вроде Claude Code?Да — можно запустить Claude Code в терминале, смотреть его вывод и отправлять ему новые задачи через инструменты с подтверждением.
Какие оболочки поддерживает терминал?Собственный PTY-бэкенд (portable-pty) поддерживает zsh, bash, pwsh, fish и cmd; на Windows любой установленный WSL-дистрибутив работает как полноценная среда воркспейса. Пространства (Spaces) восстанавливают вкладки, директории и расположение сплитов между запусками.
Что умеет встроенный редактор кода?Это CodeMirror 6 с поддержкой популярных языков (TS/JS, Rust, Python, Go, C/C++, Java и другие), ИИ-автодополнением прямо в коде на локальных моделях, принятием или отклонением ИИ-правок диффа по кускам (hunk), опциональными language-серверами, Vim-режимом, предпросмотром Markdown и медиафайлов, а также темами вроде Kanagawa, Catppuccin и Dracula.
Creator
crynta
Size
20.3 MB
Stars
9.3K
Age
5mo
Commits · 90 Days