Waveterm

영구 세션, 인라인 그래픽, 원격 연결 관리를 갖춘 AI 통합 오픈소스 터미널.

설치

플랫폼별 설치

명령어	설명
brew install --cask wave	macOS에서 Homebrew로 설치
waveterm.dev에서 다운로드	공식 웹사이트에서 설치
릴리스에서 .deb 또는 .rpm 다운로드	Linux에서 설치
릴리스에서 .exe 설치 프로그램 다운로드	Windows에서 설치
wsh version	Wave CLI 버전 표시
wsh help	사용 가능한 wsh 명령어 표시

기본 사용법

탭 및 창 관리

명령어	설명
Cmd/Ctrl + N	새 터미널 탭 열기
Cmd/Ctrl + T	새 워크스페이스 탭 열기
Cmd/Ctrl + W	현재 탭 닫기
Cmd/Ctrl + Shift + N	새 창 열기
Cmd/Ctrl + 1-9	번호로 탭 전환
Cmd/Ctrl + Shift + ]	다음 탭
Cmd/Ctrl + Shift + [	이전 탭
Cmd/Ctrl + Shift + T	마지막으로 닫은 탭 다시 열기

블록 및 패널 관리

명령어	설명
Cmd/Ctrl + Shift + D	터미널 수평 분할
Cmd/Ctrl + D	터미널 수직 분할
블록 테두리 클릭 및 드래그	터미널 패널 크기 조정
Alt + 방향키	블록 간 이동
Cmd/Ctrl + Enter	현재 블록 최대화/복원
Cmd/Ctrl + Shift + P	명령 팔레트 열기
Cmd/Ctrl + Backspace	현재 블록 닫기

AI 기능

AI 채팅

명령어	설명
Cmd/Ctrl + Space	현재 블록에서 AI 채팅 열기
AI 채팅에 질문 입력	AI에게 명령어나 코드에 대해 질문
AI 채팅에서 /explain	이전 명령 출력 설명
AI 채팅에서 /fix	마지막 오류에 대한 수정 제안
AI 채팅에서 /summarize	긴 출력 요약
AI 제안에서 “Apply” 클릭	제안된 명령을 터미널에 삽입
Esc	AI 채팅 패널 닫기

AI 프로바이더 설정

명령어	설명
설정에서 AI 모델 구성	OpenAI, Anthropic, 로컬 모델 선택
설정에서 ai:preset 설정	AI 프로바이더 간 전환
설정에서 ai:apitoken 설정	AI 프로바이더 API 키 구성
설정에서 ai:model 설정	모델 이름 지정 (예: gpt-4, claude-3)
설정에서 ai:baseurl 설정	커스텀/로컬 API 엔드포인트 지정
설정에서 ai:maxtokens 설정	최대 응답 토큰 설정

AI 설정 예시

{
  "ai:preset": "custom",
  "ai:apitoken": "sk-...",
  "ai:baseurl": "https://api.openai.com/v1",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

Ollama를 사용한 로컬 모델:

{
  "ai:preset": "custom",
  "ai:baseurl": "http://localhost:11434/v1",
  "ai:model": "llama3",
  "ai:maxtokens": 4096
}

SSH 연결

SSH 작업

명령어	설명
wsh ssh user@hostname	SSH로 원격 호스트 연결
wsh ssh user@host -i ~/.ssh/key	특정 ID 키로 SSH 연결
wsh ssh -p 2222 user@host	커스텀 포트로 SSH 연결
”+” 클릭 후 “SSH Connection”	UI에서 SSH 연결 생성
세션 간 연결 유지	앱 재시작 후에도 세션 유지
wsh ssh-import	SSH 설정 연결 가져오기
~/.ssh/config 항목 구성	SSH 호스트 자동 검색
연결 우클릭 후 재연결	끊어진 SSH 세션 재연결

SSH 설정 통합

Wave는 호스트 검색을 위해 SSH 설정을 읽습니다. 원활한 연결을 위해 항목을 구성하세요:

Host prod-web
    HostName 10.0.1.50
    User deploy
    IdentityFile ~/.ssh/deploy_key
    Port 22

Host staging-*
    HostName %h.staging.example.com
    User admin
    IdentityFile ~/.ssh/staging_key
    ForwardAgent yes

Host jump-box
    HostName bastion.example.com
    User ops
    IdentityFile ~/.ssh/ops_key

Host internal-*
    ProxyJump jump-box
    User admin
    IdentityFile ~/.ssh/internal_key

원격 파일 탐색

명령어	설명
wsh view remote:file.txt	원격 호스트의 파일 보기
wsh edit remote:file.txt	원격 호스트의 파일 인라인 편집
wsh view remote:/var/log/syslog	원격 로그 파일 보기
wsh run --remote user@host -- command	원격 호스트에서 명령을 새 블록에서 실행

위젯 및 블록

파일 및 콘텐츠 보기

명령어	설명
wsh view file.png	터미널에서 인라인으로 이미지 보기
wsh view file.jpg	JPEG 이미지 인라인 보기
wsh view file.svg	SVG 그래픽 인라인 보기
wsh view file.md	마크다운 인라인 렌더링
wsh view file.csv	CSV를 테이블로 표시
wsh view file.json	구문 강조로 JSON 표시
wsh view file.pdf	PDF 문서 미리보기
wsh view https://example.com	블록에 웹 페이지 임베드

블록 작업

명령어	설명
wsh edit file.txt	인라인 에디터에서 파일 열기
wsh edit --lang=python script.py	언어 모드로 에디터 열기
wsh getmeta	현재 블록 메타데이터 가져오기
wsh setmeta key=value	블록 메타데이터 설정
wsh run -- command args	새 블록에서 명령 실행
wsh run --magnify -- htop	최대화된 블록에서 명령 실행
wsh createblock	빈 블록 생성
wsh createblock --tabid=tab1	특정 탭에 블록 생성

위젯 사용 패턴

명령어	설명
wsh view --magnify file.png	최대화된 블록에서 이미지 보기
wsh view --height=20 file.csv	특정 블록 높이로 보기
Wave에 파일 드래그 앤 드롭	파일 직접 보기
wsh view .	현재 디렉토리 탐색
wsh view ~/projects	특정 디렉토리 탐색

커스터마이징

외관 설정

명령어	설명
설정 > 외관 열기	테마 및 색상 변경
설정 > 터미널 열기	폰트, 크기, 커서 구성
설정에서 term:fontsize 설정	터미널 폰트 크기 설정
설정에서 term:fontfamily 설정	터미널 폰트 패밀리 설정
설정에서 term:theme 설정	터미널 색상 테마 설정
설정에서 term:cursorstyle 설정	커서 스타일 설정 (block, bar, underline)
설정에서 window:transparent 설정	창 투명도 활성화
설정에서 window:blur 설정	배경 블러 활성화
설정에서 window:opacity 설정	창 불투명도 수준 설정
telemetry:enabled = false 설정	텔레메트리 비활성화

터미널 외관 설정

{
  "term:fontsize": 14,
  "term:fontfamily": "JetBrains Mono, Menlo, monospace",
  "term:theme": "dracula",
  "term:cursorstyle": "bar",
  "term:scrollback": 10000,
  "window:transparent": true,
  "window:blur": true,
  "window:opacity": 0.92
}

커스텀 테마 설정

{
  "term:theme": "custom",
  "term:localtheme": {
    "black": "#282a36",
    "red": "#ff5555",
    "green": "#50fa7b",
    "yellow": "#f1fa8c",
    "blue": "#bd93f9",
    "magenta": "#ff79c6",
    "cyan": "#8be9fd",
    "white": "#f8f8f2",
    "brightBlack": "#6272a4",
    "brightRed": "#ff6e6e",
    "brightGreen": "#69ff94",
    "brightYellow": "#ffffa5",
    "brightBlue": "#d6acff",
    "brightMagenta": "#ff92df",
    "brightCyan": "#a4ffff",
    "brightWhite": "#ffffff",
    "background": "#282a36",
    "foreground": "#f8f8f2",
    "cursor": "#f8f8f2",
    "selectionBackground": "#44475a"
  }
}

키보드 단축키

탐색

명령어	설명
Cmd/Ctrl + Shift + P	명령 팔레트
Cmd/Ctrl + L	터미널 지우기
Cmd/Ctrl + Shift + E	사이드바 토글
Cmd/Ctrl + K	검색에 포커스
Cmd/Ctrl + Shift + F	전역 검색
Alt + 방향키	블록 간 이동
Cmd/Ctrl + Enter	현재 블록 최대화/복원
Cmd/Ctrl + ,	설정 열기

편집 및 클립보드

명령어	설명
Cmd/Ctrl + Shift + C	터미널에서 복사
Cmd/Ctrl + Shift + V	터미널에 붙여넣기
Cmd/Ctrl + A	블록에서 전체 선택
Cmd/Ctrl + F	현재 블록에서 찾기
Shift + Page Up	터미널에서 위로 스크롤
Shift + Page Down	터미널에서 아래로 스크롤
Cmd/Ctrl + Home	버퍼 맨 위로 스크롤
Cmd/Ctrl + End	버퍼 맨 아래로 스크롤

블록 관리

명령어	설명
Cmd/Ctrl + D	수직 분할
Cmd/Ctrl + Shift + D	수평 분할
Cmd/Ctrl + Backspace	현재 블록 닫기
Cmd/Ctrl + Enter	블록 최대화 토글
Alt + 위/아래/왼쪽/오른쪽	블록 간 포커스 이동
Cmd/Ctrl + Shift + Arrow	현재 블록 크기 조정

설정

설정 관리

명령어	설명
wsh getvar key	설정 변수 가져오기
wsh setvar key=value	설정 변수 설정
wsh getvar --all	모든 설정 변수 목록
설정은 ~/.waveterm/에 저장	기본 설정 디렉토리
설정에서 autoupdate:enabled 설정	자동 업데이트 활성화/비활성화
설정에서 conn:askbeforewshinstall 설정	원격에 wsh 설치 전 확인 프롬프트
설정에서 editor:minimap 설정	인라인 에디터 미니맵 토글
설정에서 web:openlinksinternally 설정	Wave 브라우저 블록에서 링크 열기

전체 설정 예시

{
  "term:fontsize": 13,
  "term:fontfamily": "Fira Code, monospace",
  "term:theme": "one-dark",
  "term:cursorstyle": "block",
  "term:scrollback": 5000,
  "window:transparent": false,
  "window:blur": false,
  "telemetry:enabled": false,
  "autoupdate:enabled": true,
  "conn:askbeforewshinstall": true,
  "editor:minimap": false,
  "web:openlinksinternally": true,
  "ai:preset": "openai",
  "ai:model": "gpt-4",
  "ai:maxtokens": 2048
}

환경 변수

명령어	설명
WAVETERM_HOME=~/.waveterm	Wave 설정 디렉토리 오버라이드
WAVETERM_DEV=1	개발 모드 활성화
TERM_PROGRAM=waveterm	Wave 세션에서 자동 설정
WAVETERM_BLOCKID	현재 블록 ID (블록당 설정)
WAVETERM_TABID	현재 탭 ID (탭당 설정)

워크스페이스 관리

워크스페이스

명령어	설명
사이드바에서 워크스페이스 이름 클릭	워크스페이스 간 전환
워크스페이스 우클릭 후 이름 변경	워크스페이스 이름 변경
사이드바에서 새 워크스페이스 생성	새로운 워크스페이스 추가
워크스페이스 간 탭 드래그	탭 재구성
재시작 간 워크스페이스 유지	모든 상태 자동 저장

세션 지속성

명령어	설명
터미널 히스토리 유지	세션 간 명령 출력 저장
SSH 연결 자동 재연결	재시작 시 원격 세션 복원
탭당 블록 레이아웃 저장	패널 배치 보존
작업 디렉토리 기억	각 블록이 cwd 기억
스크롤 위치 유지	마지막 위치로 돌아가기

모범 사례

1. 멀티태스킹에 블록 사용 — 터미널을 블록으로 분할하여 로그 모니터링, 빌드 실행, 코드 편집을 나란히 수행합니다.

2. 익숙하지 않은 명령에 AI 활용 — Cmd/Ctrl + Space를 눌러 AI 어시스턴트에게 구문, 플래그, 문제 해결에 대해 질문합니다.

3. 빠른 접근을 위한 SSH 설정 구성 — 모든 서버를 ~/.ssh/config에 추가하여 Wave가 연결 메뉴에서 자동으로 검색하도록 합니다.

4. 빠른 검사를 위한 인라인 뷰어 사용 — wsh view로 터미널을 떠나지 않고 이미지, CSV, 마크다운을 미리봅니다.

5. 주요 블록 고정 — 작업에 집중할 때 Cmd/Ctrl + Enter로 중요한 블록을 최대화하고, 완료 후 레이아웃을 복원합니다.

6. 원하는 경우 텔레메트리 비활성화 — 프라이버시를 위해 설정에서 telemetry:enabled를 false로 설정합니다.

7. 프로젝트별 워크스페이스 사용 — 다른 프로젝트를 위해 별도의 워크스페이스를 만들어 컨텍스트를 정리합니다.

8. AI 모델 설정에 로컬 엔드포인트 사용 — 프라이빗 오프라인 AI 지원을 위해 ai:baseurl을 로컬 Ollama 또는 LM Studio 인스턴스로 지정합니다.

9. 블록 키보드 단축키 학습 — 탐색을 위한 Alt + Arrow와 분할을 위한 Cmd/Ctrl + Shift + D가 가장 많이 사용되는 단축키입니다.

10. 테마 커스터마이징 — term:localtheme를 사용하여 선호하는 에디터 색상과 일치하는 커스텀 색상 테마를 설정하여 일관된 경험을 제공합니다.