터미널 사용법

이 장에서는 터미널 자체에 대해 다룹니다: 입출력, 터미널 내 검색, 복사/붙여넣기 및 이미지, vopen 명령어, Windows에서의 셸 선택, 그리고 세션 녹화에 대해 설명합니다.

1. 기본 사항

터미널 세션은 실제 셸입니다 (macOS / Linux에서는 시스템 기본 셸, Windows에서는 기본적으로 cmd가 사용되며 이는 변경 가능합니다 — §5 참조). 작업 디렉터리는 기본적으로 프로젝트 루트이며, 세션의 편집 화면에서 변경할 수 있으며, 여기에는 세션 시작 시마다 자동으로 실행되는 “시작 명령어”도 제공됩니다 (예: pnpm dev).

입력 지연 시간은 특별히 설계되었습니다: 에이전트들이 화면을 가득 채울 때는 입력이 우선시되고 백그라운드 탭들의 처리 속도가 조절되어 전경 영역이 사용자의 키 입력에 뒤처지지 않습니다. 탭 전환 후 TUI에 문제가 생긴 경우, 패널 헤더에 있는 다시 그리기 버튼을 누르면 전체 화면이 다시 그려집니다.

2. 터미널 내 검색 (⌘F)

현재 터미널의 스크롤백 내용을 검색하며, 다음/이전으로 이동할 수 있습니다:

세션 및 기록 전체를 검색하려면 전역 검색(⌘⇧F)을 사용하세요 — Interface & Session Management §8 참조.

3. 복사 및 붙여넣기

• 원하는 부분을 선택하여 강조 표시한 뒤, 컨텍스트 메뉴에서 복사/붙여넣기를 선택하면 일반적인 ⌘C / ⌘V가 정상적으로 작동합니다.
• 마우스 입력을 지원하는 TUI 프로그램(vim, htop 등)에서는 일반 텍스트 선택을 강제하려면 드래그할 때 Option/Alt 키를 누르고 있어야 합니다.

이미지 붙여넣기는 에이전트에 이미지를 전달하는 기능입니다: 스크린샷이나 이미지 파일을 터미널에 붙여넣거나 드래그하면 VelaTerm가 해당 이미지를 임시 위치에 저장한 뒤 터미널에 파일 경로를 표시합니다 — 이는 claude와 같은 CLI들이 기대하는 방식과 정확히 동일합니다. 관련 설정으로는 “이미지 붙여넣기”에서 “파일로 업로드” (항상 경로로 저장됨)와 “에이전트 기본값” 중 선택할 수 있으며, “자동으로 붙여넣은 이미지 삭제” 기능을 통해 주기적으로 임시 이미지들을 삭제할 수 있고 “지금 삭제” 버튼도 제공됩니다.

4. vopen: 터미널에서 파일 및 페이지 열기

각 세션의 PATH에는 설치가 필요 없는 세 가지 간단한 명령어(vopen, vspawn, vspawn-tree)가 포함되어 있습니다. 이들은 터미널 명령어이며, claude 대화 내부에서 사용되는 동명의 / 스킬들은 별개의 것으로, 설정 ▸ 일반에서 Vela Skills 옵션을 켜야 사용할 수 있습니다. vopen는 해당 내용들을 중앙 패널로 전송합니다:

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

전체 문서 탭 기능 (이중 모드 편집, 찾기 및 바꾸기, PDF 내보내기): Document & Browser Tabs. vspawn을 통해 생성: Session Spawning & Git Collaboration.

5. 셸 선택 (Windows에서만 가능)

Windows에서는 터미널 세션에서 새로 만들기 하위 메뉴, 세션 편집 화면의 드롭다운 목록, 또는 마우스 오른쪽 버튼 “Shell ▸”를 통해 PowerShell / pwsh / cmd / Git Bash 중에서 명시적으로 셸을 선택할 수 있습니다. 실행 중인 세션은 재시작 시 이 변경 사항이 적용됩니다. 설정 ▸ Terminal ▸ “기본 셸”에서는 새 세션의 기본 셸을 지정할 수 있습니다.

포함된 Git Bash에 대해 설명하자면, 전체 설치 파일에는 git, ssh, perl을 포함한 완전한 버전이 포함되어 있으며, 최소 설치 파일에는 핵심 기능만 포함되어 있습니다. 누락된 명령어가 있으면 필요에 따라 전체 버전을 다운로드하도록 안내되며, 마우스 오른쪽 버튼 “Download full Git Bash”를 통해서도 다운로드할 수 있습니다. 에이전트 세션은 영향을 받지 않으며 항상 PowerShell을 사용합니다.

macOS / Linux에는 셸 선택기가 없으며, 세션들은 시스템 기본 셸($SHELL)을 사용합니다.

6. 세션 녹화

설정 ▸ 고급 ▸ “세션 로그 녹화” (기본적으로 꺼져 있음). 이 기능을 켜면 세션 시작 시점부터 터미널 내용이 로컬 파일에 녹화되며, 세션당 50MB까지 저장됩니다. 이 기능은 두 가지 이점을 제공합니다:

• 보관된 세션을 통해 터미널의 원래 모습 그대로 재생할 수 있습니다;
• 전역 검색을 통해 일반 터미널 출력 내용도 찾을 수 있습니다 (에이전트 대화는 텍스트 기록이 있으므로 녹화가 필요하지 않습니다).

세션이 삭제되면 녹화 파일들도 함께 삭제됩니다.

7. 일반 단축키

macOS아래에 기본 단축키가 나와 있습니다; Windows / Linux에서는 ⌘ 대신 Ctrl+Alt를 사용해야 하며 (몇 가지 예외가 있으니 설정 페이지를 확인하세요). ⌘1–9와 글꼴 크기 관련 단축키를 제외한 모든 단축키는 설정 ▸ Shortcuts에서 재지정할 수 있습니다.