CLI 전체화면 모드

목표

/fullscreen으로 대화를 전용 터미널 화면에 띄우고, 스크롤·도구 출력 펼치기·복사를 다루는 방법을 익힙니다.

개념

Kiro CLI는 기본적으로 셸 기록 사이에 인라인으로 출력합니다. 전체화면 모드는 대화를 별도 화면으로 옮겨 자체 스크롤을 제공합니다. 인라인으로 돌아오면 기존 터미널 스크롤백도 그대로 남아 있습니다.

전체화면에서는:

• 대화가 셸 기록과 따로 스크롤됩니다.
• 마우스, 터치패드, 키보드로 이전 메시지를 봅니다.
• 위로 스크롤해 있는 동안에도 새 메시지가 쌓입니다.
• 나갈 때 전체화면에서 생긴 메시지가 인라인 기록에 추가됩니다.

/fullscreen 전환은 TUI와 Lite 인터페이스에서 쓸 수 있고, 시작 시 전체화면 설정은 대화형 TUI 세션에 적용됩니다.

켜고 끄기

/fullscreen을 입력하면 들어가고, 다시 입력하면 인라인으로 돌아옵니다. 전환용 단축키는 없습니다. 모드를 바꿔도 대화가 초기화되거나 새 세션이 시작되지 않습니다.

새 세션을 항상 전체화면으로 시작하려면 /settings → Display → Full Screen → Start fullscreen을 켭니다. 다음 대화형 TUI 실행부터 적용됩니다. 이 설정과 상관없이 /fullscreen으로 현재 세션만 바꿀 수 있습니다.

스크롤

단축키	동작
PageUp / PageDown	한 페이지 위아래
Home	프롬프트가 비어 있을 때 가장 오래된 내용으로
End	위로 스크롤해 있을 때 최신 내용으로

프롬프트에 글자가 있으면 Home은 입력란의 맨 앞으로 커서를 옮깁니다. 위로 스크롤하면 새 메시지 수를 보여 주는 버튼이 프롬프트 위에 나타나며, 누르거나 End로 최신 위치로 돌아갑니다.

TUI에서는 /settings → Display → Full Screen → Scroll speed로 휠 한 번에 움직이는 줄 수(1, 2, 3, 기본 2)를 바꿀 수 있습니다.

도구 출력과 복사

• 긴 도구 출력은 미리보기로 보입니다. Ctrl+O는 최근 20개 도구 출력을 한꺼번에 펼치거나 접고, 도구 호출 아래 토글 글자를 누르면 하나만 펼칩니다.
• 마우스로 끌어 선택하면 클립보드로 복사됩니다. macOS는 pbcopy, Windows는 Set-Clipboard, Linux는 wl-copy·xclip·xsel을 쓰고, 없으면 OSC 52 터미널 이스케이프로 복사를 요청합니다.
• 복사 확인 메시지는 Kiro가 선택한 텍스트를 알려 줄 뿐, 터미널이 클립보드 쓰기를 받아들였는지는 확인하지 않습니다.
• /copy는 마지막 응답을 복사하고, /transcript는 전체 대화를 pager로 열며, /transcript save <path>는 파일로 저장합니다.

언제 어떤 모드를 쓰나

상황	권장
짧은 일회성 질문	인라인
긴 코딩 세션	전체화면
긴 설명이나 코드 리뷰 읽기	전체화면
터미널 기록을 옆에 계속 보기	인라인
발표·화면 공유	전체화면

문제 해결

증상	조치
깜빡이거나 화면이 깨짐	터미널·멀티플렉서가 alternate screen을 지원하는지 확인. tmux는 ~/.tmux.conf에 set -g alternate-screen on
마우스 스크롤이 안 됨	Entered fullscreen 알림이 떴는지, 터미널의 마우스 리포팅이 꺼져 있지 않은지 확인
마우스로 선택이 안 됨	/copy나 /transcript를 쓰거나, 대부분의 터미널에서 Shift를 누른 채 끌어 터미널 자체 선택 사용
복사했는데 클립보드가 안 바뀜	OSC 52가 막힌 경우가 많음. tmux는 set -g set-clipboard on 후 tmux source-file ~/.tmux.conf. iTerm2는 Settings → General → Selection → Applications in terminal may access clipboard를 켬. macOS Terminal.app은 OSC 52를 지원하지 않으므로 /transcript save <path> 사용

tmux의 allow-passthrough를 켜도 클립보드 쓰기는 허용되지 않으므로 set-clipboard on이 따로 필요합니다. 아주 큰 텍스트는 OSC 52 크기 제한에 걸릴 수 있어 /transcript save <path>가 낫습니다.

더 알아보기

• CLI로 앱 만들기: CLI 세션 슬래시 명령
• CLI Voice 모드

---

출처: Fullscreen mode (2026-10-26 확인)