vlinx-io/VelaTerm
요약
VelaTerm은 단순한 터미널과 IDE의 기능을 결합한 차세대 개발 환경입니다. Codex, Claude Code 등 주요 코딩 에이전트 세션을 관리하고, iTerm2처럼 창을 분할하여 사용할 수 있습니다. 이를 통해 모든 작업을 하나의 네이티브 앱에서 통합적으로 처리할 수 있게 합니다.
핵심 포인트
- Codex와 iTerm2의 기능을 결합한 올인원 개발 환경 제공
- Claude Code 등 주요 코딩 에이전트 세션을 관리하고 재개 가능
- 프로젝트-그룹-세션 구조로 체계적인 작업 공간 구성 지원
VelaTerm
English | 简体中文
최고의 ADE. 단순한 터미널이 아닙니다. 단순한 IDE도 아닙니다.
Codex처럼 에이전트 세션을 관리하고, iTerm2처럼 터미널을 분할하세요. VelaTerm은 이 두 가지 기능을 하나의 네이티브 앱에 담았으며, 이를 브라우저와 휴대폰에서도 사용할 수 있게 합니다.
<a href="https://www.youtube.com/watch?v=X665-GPmaKw"><img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/velaterm-intro-cover-3a-equation-en.jpg" alt="Codex 세션 관리와 iTerm2 분할 창이 결합된 결과물이 에이전트 개발 환경인 VelaTerm입니다. 소개 영상을 시청하세요." width="100%"></a>
소개 영상 보기 (2:55) ·
다운로드 ·
사용자 매뉴얼
작업 공간 (Workspace)
모든 주요 코딩 에이전트
Claude Code, Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi 등. 각각은 라이브 상태 표시, 재개(resume), 사용자 지정 실행 인수를 갖춘 관리형 세션으로 실행됩니다.
<img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/window.webp" alt="하나의 VelaTerm 창에서 Claude Code, Codex, 개발 서버 및 셸을 나란히 배치하여 보여줍니다." width="100%">완벽한 에이전트 개발 환경
에이전트의 계획(plan), 편집 내용(edits), 명령어(commands) 및 테스트 결과를 대화처럼 따라가거나, 동일 세션을 터미널 뷰로 전환하여 TUI에서 작업할 수 있습니다.
<img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/views-conversation.webp" alt="계획, 편집 내용, 명령어 및 테스트 결과가 포함된 대화 뷰의 에이전트 세션입니다." width="100%">트리 형태의 세션
프로젝트(Projects) → 그룹(groups) → 중첩된 하위 그룹(nested sub-groups) → 세션(sessions). 얼마나 많은 세션을 실행하든 순서가 유지됩니다. 모든 세션은 백그라운드에서 계속 실행되는 실제 가상 터미널(pseudo-terminal)이며, 세션들을 나란히 분할하여 사용할 수 있습니다.
<p align="center"><img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/tree.webp" alt="세션 트리에서 프로젝트, 그룹, 중첩된 그룹 및 세션" width="440"></p>명령어와 경로 (Commands and paths), 입력하는 동안
명령어와 경로 제안이 나타납니다. 화살표 키로 선택한 후 Tab을 누르면 수락됩니다.
<img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/suggest-commands.webp" alt="git 명령어를 입력하는 동안 나타나는 명령어 제안" width="100%">에이전트가 도움이 필요할 때를 인지하다
세션 상태는 세션 트리와 상태 표시줄에서 대화 내용을 따라가며, 에이전트가 작업을 완료하고 사용자를 기다릴 때 데스크톱 알림을 제공합니다.
<img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/status.webp" alt="세션 트리, 상태 표시줄 및 알림에서의 세션 상태" width="100%">사용량과 부하 (Usage and load), 실시간으로
에이전트가 작동하는 동안 오른쪽 패널은 플랜 할당량(plan quota), 컨텍스트(context), 토큰(tokens) 및 시스템 부하를 표시합니다.
<p align="center"><img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/info-panel.webp" alt="플랜 할당량, 컨텍스트, 토큰 및 시스템 부하가 표시된 정보 패널" width="440"></p>에이전트 간의 협업 (Agents together)
하나의 명령어, 하나의 하위 세션
에이전트는 vspawn을 사용하여 자식 세션(child session)에 보조 작업을 할당할 수 있습니다. 필요한 경우 에이전트, 모델 및 노력을 선택하고 자체 작업 트리(worktree)를 제공합니다. 자식 세션은 트리의 부모 아래에 나타납니다.
세션 간의 대화 (Agents talk across sessions)
Claude, Codex, OpenCode 또는 Pi로 실행되는 세션들은 서로의 대화를 검색하고, 그 내용에 대해 질문하며, 메시지를 주고받을 수 있습니다.
| 명령어 | 기능 |
|---|---|
vsearch | 모든 세션 검색 |
| ... |
하나의 큰 작업, 여러 세션 팀 구성하기
Plan / Execute 모드는 대규모 작업을 여러 에이전트 세션에 분산하여 각 세션이 하나의 임무를 맡도록 합니다. **플래너(planner)**가 계획을 작성하고, 작업을 분할하며, 모든 결과를 검토합니다. **실행자(executors)**들은 각각 자신의 작업 트리에서 한 부분을 구축하고 보고합니다.
- 계획 (Plan). 계획 및 실행에 필요한 에이전트, 모델, 추론 노력을 개별적으로 선택합니다.
- 실행 (Execute). 플래너가 분할을 제안하면, 시작하기 전에 작업을 수정하고 모델을 지정할 수 있습니다. 이후 실행자들은 각각 하나의 작업 트리를 가지고 병렬로 작동하며, 세션 트리에서 플래너의 자식 노드가 됩니다.
- 검토 (Review). 보고서는 자동으로 플래너에게 돌아옵니다. 기준에 미치지 못하는 것은 컨텍스트가 유지된 채 동일한 세션으로 다시 보내집니다.
세션이 학습한 내용을 유지하기
세션을 '세션 지식 기반(Session Knowledge Base)'으로 구성하고, 로컬 지식 기반에 마크다운 노트를 보관하며, 이 두 곳을 동시에 검색할 수 있습니다. vkb를 사용하면 에이전트가 행동하기 전에 정보를 조회합니다:
| 명령어 | 조회 대상 |
|---|---|
vkb memories | 세션 지식 |
| ... | |
| 지식 노트에 대한 내용은 노트북 가이드를 참고하세요. |
내장 도구 (Built-in tools)
포함된 에디터 (Editors included)
WYSIWYG Markdown 에디터, 코드 에디터, 이미지 뷰어와 데스크톱용 내장 브라우저가 포함되어 있습니다. 이 모든 것은 원격(remote) 머신에서도 작동합니다.
<img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/editor-markdown.webp" alt="파일 트리와 함께 있는 WYSIWYG Markdown 에디터" width="100%">작업 사이에 잠시 휴식 (A little break between tasks)
작업 공간에서 Game Center를 열고 키보드, 터치 컨트롤 또는 컨트롤러로 Pixel Wing을 플레이하세요.
<p align="center"><img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/game.webp" alt="Game Center의 Pixel Wing" width="520"></p>추가 포함 기능 (Also included)
- 코드 감사(Code audits). 로컬 Codex 또는 Claude Code를 사용하여 소스 증거, 커버리지 한계 및 Markdown/JSON 보고서가 포함된 번들 Codex Security 워크플로우입니다. 코드 감사 가이드를 참고하세요.
- Git 통합(Git integration). 세션별 브랜치, ahead/behind 및 변경 횟수와 일반적인 작업들이 포함됩니다.
- 테마 및 언어(Themes and languages). 시스템을 따르는 라이트 및 다크 테마, 그리고 완전히 번역된 인터페이스를 제공합니다.
어디서든 (Anywhere)
어디서든 실행 (Run it anywhere)
원격 액세스가 내장되어 있습니다. SSH를 통해 연결하거나 종단 간 암호화(end-to-end encryption)를 사용하여 HTTPS로 앱을 서비스할 수 있습니다.
- 데스크톱(Desktop). macOS, Windows 및 Linux용 네이티브 앱입니다. 앱 내부에서 SSH를 통해 원격 장치에 연결할 수 있습니다.
- 브라우저(Browser). 어떤 기기에서든 URL을 열 수 있습니다. 설치가 필요 없습니다. HTTPS를 통해 종단 간 암호화(end-to-end encryption)로 제공되므로, 네트워크를 가로지르는 읽을 수 있는 데이터는 없습니다.
- 폰(Phone). iOS 및 Android용 네이티브 앱입니다. QR 코드를 스캔하여 동일한 세션 트리(session tree)를 휴대할 수 있습니다.
원격 연결, 세 가지 방식
SSH를 통해 연결하거나, 페어링 링크(pairing link)를 열거나, 계정에 로그인하여 사용 가능한 장치 중 하나를 선택할 수 있습니다.
<img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/remote-ssh.webp" alt="SSH를 통해 원격 서버에 연결하는 모습" width="100%">주머니 속의 세션
QR 코드를 스캔하여 연결합니다. 트리를 탐색하고, 에이전트(agent) 답변을 스트리밍되는 대로 읽고 답장하며, 에이전트가 사용자를 필요로 할 때 푸시 알림을 받을 수 있습니다.
<p align="center"><img src="https://raw.githubusercontent.com/vlinx-io/VelaTerm/HEAD/docs/assets/readme/mobile.webp" alt="세션 트리와 에이전트 답변을 보여주는 iOS 및 Android 앱" width="560"></p>macOS, Windows 및 Linux
모든 데스크톱에 설치되는 네이티브 앱입니다. Windows의 경우, Git Bash가 전체 설치 프로그램과 함께 번들로 제공됩니다. Tauri 2를 기반으로 구축되어 무거운 터미널 부하에서도 원활하게 작동하는 작은 설치 파일입니다.
| 플랫폼 | 아키텍처 | 셸 |
|---|---|---|
| macOS | Apple Silicon, Intel | zsh |
| ... |
다운로드 (Download)
첫 번째 명령어부터 최종 검토까지. 사용 중인 플랫폼의 설치 파일을 velaterm.com/download에서 받은 다음, 시작 가이드(getting started guide)로 시작하세요.
문서 (Documentation)
- 매뉴얼 개요 — 여기서 시작하세요
- 시작하기(Getting started)
- AI 에이전트 세션
- 원격 개발 가이드
- 변경 로그(Changelog)
커뮤니티 (Community)
- X — 릴리스 발표 및 짧은 데모.
- YouTube — 애플리케이션 데모 및 안내 투어.
- Discord — 질문, 버그 보고 및 일상적인 토론.
- velaterm.com — 다운로드, 매뉴얼 및 변경 로그.
개발 (Development)
기술 스택 (Tech stack)
| 레이어 | 선택지 |
|---|---|
| 데스크톱 셸 | Tauri 2.x (Rust 백엔드 + 시스템 WebView); electron/에도 Electron 셸이 존재함 |
| ... |
소스에서 빌드하기 (Build from source)
사전 요구 사항: Node.js, pnpm, Rust 툴체인, 그리고 git.
Tauri는 플랫폼 종속성도 필요합니다 — Tauri 사전 요구 사항 가이드를 참조하세요.
pnpm install # 프론트엔드 종속성 설치
pnpm dev:desktop # Rust 백엔드를 빌드하고 데스크톱 창 열기
다른 개발 모드:
pnpm dev:web # 헤드리스(headless) 백엔드 + Vite, 일반 브라우저에서 구동
pnpm dev:electron # Tauri 대신 Electron 쉘 사용
pnpm dev:ls # 실행 중인 개발 인스턴스 목록 보기
...
모든 개발 인스턴스는 임의의 포트를 할당받고 레이블을 가지므로 여러 개를 나란히 실행할 수 있습니다. dev:web은 0.0.0.0에 바인딩되므로 다른 컴퓨터나 휴대폰에서 열 수 있는 LAN 주소도 출력하며, 실제 세션 트리를 건드리지 않고 .dev-data/ 아래의 격리된 데이터베이스를 기본으로 사용합니다.
빌드 및 테스트:
pnpm build # 타입 체크 및 프론트엔드 번들링
pnpm tauri build # 데스크톱 애플리케이션 빌드
pnpm test # 프론트엔드 테스트 (vitest)
...
프로젝트 레이아웃
src/ React 프론트엔드
layout/ 세 개의 열 + 하단 바 영역
store/ Zustand 상태
...
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기