Ch7. TUI 고급 활용
/compact·/share 등 슬래시 커맨드, @파일·!셸·Tab 입력 기능, ctrl+x 리더 키바인딩과 tui.json 커스터마이즈, 컴팩트 모드·워크스페이스 등 생산성 팁을 다룹니다.
핵심 요약
- TUI는
/connect·/compact·/share·/init등 슬래시 커맨드로 세션을 관리하며 대부분ctrl+x리더 키바인딩이 연결돼 있습니다. - 입력창에서
@로 파일 참조,!로 셸 출력 삽입,Tab으로 Build↔Plan 전환, 드래그앤드롭으로 이미지·텍스트(v1.2.26+)를 첨부합니다. - 커맨드 팔레트는 v1.3.1+에서
Cmd+K로 변경되었고,F2로 최근 모델을 빠르게 순환합니다. tui.json의keybinds에서 키를 재지정하거나"none"으로 비활성화하고, 테마·스크롤 속도·diff 스타일을 설정합니다.- 긴 세션은
/new로 분리하고/compact로 압축해 컨텍스트 오염과 토큰 낭비를 줄입니다.
OpenCode TUI는 긴 세션을 관리하는 기본 인터페이스입니다. 단축키와 슬래시 커맨드를 얼마나 손에 익히느냐가 생산성을 좌우합니다.
슬래시 커맨드
| 커맨드 | 기능 | 키바인딩 |
|---|---|---|
/connect | API 프로바이더 추가 | — |
/compact | 세션 컨텍스트 요약 | ctrl+x c |
/details | 도구 상세 표시 토글 | ctrl+x d |
/editor | 외부 편집기 열기 | ctrl+x e |
/exit | OpenCode 종료 | ctrl+x q |
/export | Markdown으로 내보내기 | ctrl+x x |
/help | 도움말 표시 | ctrl+x h |
/init | AGENTS.md 자동 생성 | ctrl+x i |
/models | 모델 목록 | ctrl+x m |
/new | 새 세션 시작 | ctrl+x n |
/redo | 되돌리기 취소 | ctrl+x r |
/sessions | 세션 전환 | ctrl+x l |
/share | 세션 공유 | ctrl+x s |
/themes | 테마 목록 | ctrl+x t |
/thinking | 추론 과정 표시 토글 | — |
/undo | 마지막 메시지 되돌리기 | ctrl+x u |
/unshare | 공유 해제 | — |
입력 특수 기능
| 기능 | 사용법 | 설명 |
|---|---|---|
| 파일 참조 | @ 입력 | 퍼지 파일 검색으로 컨텍스트에 추가 |
| 셸 출력 | ! 접두사 | 셸 명령 실행 결과를 컨텍스트에 삽입 |
| 모드 전환 | Tab | Build ↔ Plan 전환 |
| 이미지 첨부 | 드래그앤드롭 | 터미널에 이미지를 드래그하여 첨부 |
| 텍스트 첨부 | 드래그앤드롭 | 텍스트 파일을 드래그하여 첨부 (v1.2.26+) |
| 커맨드 팔레트 | Cmd+K | 커맨드 팔레트 열기 (v1.3.1+, 기존 단축키에서 변경) |
키바인딩 시스템
기본 리더 키: ctrl+x
세션 관리
| 동작 | 키바인딩 |
|---|---|
| 종료 | ctrl+c, ctrl+d, <leader>q |
| 새 세션 | <leader>n |
| 세션 목록 | <leader>l |
| 세션 내보내기 | <leader>x |
탐색 & 편집
| 동작 | 키바인딩 |
|---|---|
| 외부 편집기 | <leader>e |
| 사이드바 토글 | <leader>b |
| 응답 복사 | <leader>y |
| 되돌리기 | <leader>u |
| 되돌리기 취소 | <leader>r |
모델 & 에이전트
| 동작 | 키바인딩 |
|---|---|
| 모델 목록 | <leader>m |
| 최근 모델 순환 | F2 |
| 에이전트 목록 | <leader>a |
| 에이전트 순환 | Tab |
입력 제어
| 동작 | 키바인딩 |
|---|---|
| 전송 | Return |
| 줄바꿈 | Shift+Return, Ctrl+Return, Alt+Return, Ctrl+J |
| 줄 시작 | Ctrl+A |
| 줄 끝 | Ctrl+E |
| 줄 삭제 | Ctrl+Shift+D |
키바인딩 커스터마이즈
tui.json에서 키바인딩을 변경할 수 있습니다.
{
"$schema": "https://opencode.ai/tui.json",
"keybinds": {
"session_compact": "none",
"session_new": "<leader>n",
"model_list": "ctrl+m"
}
}"none"으로 설정하면 해당 키바인딩을 비활성화합니다.
TUI 설정 옵션
| 옵션 | 설명 | 기본값 | 버전 |
|---|---|---|---|
theme | UI 테마 | — | — |
keybinds | 키바인딩 오버라이드 | — | — |
scroll_speed | 스크롤 속도 | 3 | — |
scroll_acceleration.enabled | macOS 스타일 부드러운 스크롤 | — | — |
diff_style | diff 표시 스타일 | "auto" | — |
compact | 컴팩트 UI 모드 | false | v1.2.16 |
컴팩트 UI 모드 (v1.2.16+)
화면 공간을 절약하는 축약된 레이아웃입니다. 작은 화면이나 분할 터미널에서 유용합니다.
워크스페이스 지원 (v1.2.24+)
v1.2.24부터 TUI가 워크스페이스를 지원합니다. 모노레포에서 하위 프로젝트마다 세션을 따로 둘 수 있습니다.
세션 히스토리 페이지네이션 (v1.2.26+)
세션 목록(/sessions)에서 페이지네이션을 지원합니다. 세션이 잔뜩 쌓여도 목록을 빠르게 넘겨볼 수 있습니다.
고급 팁
- 세션 분리: 작업 단위로
/new로 새 세션을 분리해 맥락 오염을 줄입니다 - 컨텍스트 압축: 긴 세션은
/compact로 요약하여 토큰을 절약합니다 - 외부 편집기: 긴 프롬프트는
/editor로 외부 편집기에서 작성합니다 - 공유 제어: 민감한 작업은
/unshare로 비활성화하고, 필요 시에만/share
참고 문서
- TUI 사용법: https://opencode.ai/docs/tui
- 키바인딩: https://opencode.ai/docs/keybinds
- 커맨드 목록: https://opencode.ai/docs/commands