Terax

가볍고 터미널 중심인 AI 네이티브 개발 워크스페이스.

다운로드

--- Terax는 Tauri 2 + Rust와 React 19로 만든 가볍고 오픈 소스이며 터미널 중심인 AI 네이티브 개발 환경(ADE)입니다. WebGL 렌더러를 갖춘 네이티브 PTY 백엔드, 사용자의 키나 완전한 로컬 모델로 실행되는 에이전트형 AI 사이드 패널, 코드 편집기, 파일 탐색기, Git 그래프를 포함한 소스 제어, 웹 미리보기 패널이 내장되어 있습니다. 디스크 사용량은 약 7-8 MB입니다. 원격 측정 없음. 계정 필요 없음. ## 스크린샷

_{로컬 개발 서버의 웹 미리보기}	_{코드 편집기에서 편집 차이를 보여 주는 에이전트형 AI 워크플로}
_{사용자 지정 테마, 프리셋, 배경 이미지}	_{히스토리에 Git 그래프가 포함된 소스 제어 패널}
_{편집기형 입력 패널을 갖춘 블록 기반 WebGL 터미널}

## 기능 ### 터미널 - WebGL 렌더러, 다중 탭, 백그라운드 스트리밍을 지원하는 xterm.js - 편집기와 같은 명령 입력을 갖춘 GPU 가속 블록 기반 터미널 - `portable-pty`를 통한 네이티브 PTY 백엔드(zsh, bash, pwsh, fish, cmd) - 가로 및 세로 분할 패널 - 인라인 검색, 링크 감지, 트루 컬러 - 탐색기나 데스크톱의 파일을 셸에서 안전하게 인용된 경로로 터미널에 드래그 - Windows의 탭별 워크스페이스 환경(Local 또는 설치된 WSL 배포판) - Spaces가 탭, 작업 디렉터리, 분할 레이아웃을 다음 실행 시 복원 ### 코드 편집기 - CodeMirror 6(TS/JS, Rust, Python, Go, C/C++, Java, HTML/CSS, JSON, Markdown 등 주요 언어 지원) - 로컬 모델을 지원하는 인라인 AI 자동 완성 - AI 편집 차이를 헝크별로 수락하거나 거부 - 진단, 탐색, 완성, 포매팅, 사용자 지정 서버를 제공하는 선택형 언어 서버 - Markdown 렌더링과 이미지, 비디오, 오디오, PDF 보기 - Vim 모드 - Kanagawa, Catppuccin, Rosé Pine, Everforest, Dracula, Solarized, Nord, Tokyo Night, GitHub, Xcode 등의 내장 테마 ### 소스 제어 - 헝크 스테이지 / 스테이지 해제, 커밋(Cmd+Enter / Ctrl+Enter), 업스트림을 인식하는 푸시 - 분리된 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를 실행하고 출력을 확인한 뒤 승인형 도구로 후속 작업 전송 - **작성기:** `#handle` 프롬프트 스니펫, `@path` 파일, 음성 입력, 탐색기나 선택 항목에서 에이전트로 첨부 - 자체 시스템 프롬프트와 도구 하위 집합을 가진 **사용자 지정 에이전트** - 실행 전에 계획을 만들고 확인하는 **계획 모드** ## 설치 최신 설치 프로그램은 [Releases](https://github.com/crynta/terax-ai/releases/latest) 페이지에 있습니다. Terax는 이 페이지에서 자동 업데이트됩니다. ### Windows 참고 사항 - 기본 셸 감지: `pwsh.exe`(PowerShell 7+) -> `powershell.exe`(Windows PowerShell 5.1) -> `cmd.exe`. - WSL은 래핑된 하위 프로세스가 아니라 완전한 워크스페이스 환경입니다. ### Linux 참고 사항 - **Arch / AUR:** `yay -S terax-bin` 또는 `paru`. 최신 릴리스를 추적합니다. - **NixOS / Nix:** 공식 flake를 사용하세요. NixOS 외부에서는 `nix profile install github:crynta/terax-ai`를 실행합니다. NixOS에서는 flake를 가져오고 `inputs.terax.packages.${pkgs.system}.terax`를 `environment.systemPackages`에 추가합니다. 더 간단한 설정에는 `nixosModules.terax`도 있습니다. - **AppImage:** FUSE가 필요합니다. 없다면 `./Terax_*.AppImage --appimage-extract-and-run`을 실행하세요. Wayland 렌더링 문제가 있으면 `WEBKIT_DISABLE_DMABUF_RENDERER=1`을 시도하세요. `.deb` / `.rpm` 패키지는 시스템 GTK 스택을 사용해 보통 더 부드럽습니다. ## AI 설정 1. **설정 -> AI**를 엽니다. 2. 제공자를 선택하고 API 키를 붙여 넣습니다. 로컬 추론은 LM Studio / MLX / Ollama 엔드포인트를 지정합니다. 3. 키는 `keyring`을 통해 OS 키체인에 저장됩니다. 디스크나 localStorage에는 기록되지 않습니다. ## 소스에서 빌드 **필수 항목** - Rust(stable), https://rustup.rs - Node 20+와 [pnpm](https://pnpm.io) - 플랫폼별 Tauri 필수 항목, https://tauri.app/start/prerequisites/ **실행** ```bash pnpm install pnpm tauri dev # 개발 pnpm tauri build # 프로덕션 번들 ``` **검사** ```bash pnpm lint pnpm check-types pnpm test cd src-tauri && cargo clippy --all-targets --locked -- -D warnings # CI와 동일한 Rust 린트 cd src-tauri && cargo nextest run --locked # 또는 cargo test --locked ``` ## 기술 스택 Tauri 2, Rust, `portable-pty`, React 19, TypeScript, Vite, xterm.js, CodeMirror 6, Vercel AI SDK v6, Tailwind v4, shadcn/ui, Zustand. ## 기여 Issue와 PR을 환영합니다. 문제를 보고하고 기능을 제안하거나 Pull Request를 제출하세요. 자세한 내용은 [CONTRIBUTING.md](../../CONTRIBUTING.md)와 [아키텍처 문서](../README.md)를 참조하세요. ## 코드 서명

Windows 빌드는 [SignPath.io](https://signpath.io)가 제공하고 [SignPath Foundation](https://signpath.org)이 발급한 무료 코드 서명 인증서로 서명됩니다.
## 라이선스 Terax는 Apache-2.0 라이선스를 따릅니다. 종속성에 대한 자세한 내용은 [Apache License 2.0](../../LICENSE)을 참조하세요.