runbooks/kitty-setup-guide.md

Kitty Terminal 완벽 설정 가이드

최적화된 kitty 터미널 환경 구성 가이드입니다. Fira Code Nerd Font, Dracula 테마, Fish Shell, tmux 통합이 포함되어 있습니다.

📋 목차

• 설치된 구성 요소
• 폰트 설정
• 테마 설정
• Shell Integration
• tmux 통합
• 키보드 단축키
• 유용한 명령어
• 설정 파일 위치

🚀 설치된 구성 요소

폰트

• Fira Code Nerd Font: 리가처와 아이콘 지원
• D2Coding: 한글 최적화 (주석 처리됨, 필요시 활성화 가능)

테마

• Dracula Theme: 눈에 편한 어두운 테마

Shell 통합

• Fish Shell: 스마트한 자동완성과 구문 강조
• Fisher: Fish 플러그인 매니저
• 플러그인들:
  • done: 명령어 완료 알림
  • pisces: 자동 괄호 닫기
  • fzf.fish: 퍼지 파인더 통합

멀티플렉서

• tmux: 세션 관리와 창 분할
• Dracula 테마: kitty와 일치하는 색상

🎨 폰트 설정

현재 설정

# 폰트 패밀리 (Fira Code Nerd Font)
font_family      FiraCode Nerd Font
bold_font        FiraCode Nerd Font Bold
italic_font      FiraCode Nerd Font Light
bold_italic_font FiraCode Nerd Font SemiBold

# 폰트 크기
font_size 17.0

리가처 예시

• != → ≠
• >= → ≥
• => → ⇒
• -> → →
• === → ≡

🧛‍♂️ Dracula 테마

색상 팔레트

• 배경: #282a36 (어두운 보라)
• 전경: #f8f8f2 (밝은 회색)
• 보라: #bd93f9
• 핑크: #ff79c6
• 청록: #8be9fd
• 녹색: #50fa7b
• 노랑: #f1fa8c

설정 방법

# Dracula 테마 적용
include dracula.conf

🐚 Shell Integration

kitty + Fish 통합 기능

자동 설치된 플러그인

# Fisher 플러그인 매니저
fisher install jorgebucaran/fisher

# 유용한 플러그인들
fisher install franciscolourenco/done      # 명령어 완료 알림
fisher install laughedelic/pisces          # 자동 괄호 닫기
fisher install PatrickF1/fzf.fish         # 퍼지 파인더

kitty 전용 명령어

icat image.png          # 터미널에서 이미지 보기
kdiff file1 file2       # kitty diff 도구
kssh user@server        # kitty SSH (ssh로 alias됨)
preview                 # fzf 파일 미리보기

# kitten 유틸리티 (새로 추가됨)
img filename.png        # 이미지 보기 (icat 간편 alias)
imgls                   # 현재 폴더 이미지들 갤러리로 보기
clipboard               # 클립보드 히스토리 관리
unicode                 # 유니코드 문자 입력기
hgrep pattern files     # 클릭 가능한 grep 결과

SSH 최적화

# fish config에서 ssh가 kssh로 alias됨
alias ssh=kssh

# kitty SSH의 장점:
# - 테마 동기화 (Dracula 테마가 원격에서도 적용)
# - 드래그&드롭 파일 전송
# - 이미지 표시 지원
# - 고급 키보드 프로토콜

📺 tmux 통합

tmux Dracula 테마

# 상태바 색상
set -g status-style 'bg=#282a36 fg=#f8f8f2'
set -g status-left '#[fg=#282a36,bg=#bd93f9,bold] #S #[fg=#bd93f9,bg=#282a36] '
set -g status-right '#[fg=#50fa7b,bg=#282a36] %Y-%m-%d #[fg=#8be9fd,bg=#282a36] %H:%M #[fg=#282a36,bg=#ff79c6,bold] #h '

# 패널 경계선
set -g pane-border-style 'fg=#6272a4 bg=#282a36'
set -g pane-active-border-style 'fg=#bd93f9 bg=#282a36'

kitty 최적화

# tmux.conf에서 kitty 지원
set -g default-terminal "xterm-kitty"
set -g terminal-overrides "xterm-kitty:Tc"
set -s extended-keys on
set -as terminal-features 'xterm-kitty:extkeys'

⌨️ 키보드 단축키

kitty 기본 단축키

# 폰트 크기 조절
Cmd + =/-/0          # 크기 증가/감소/초기화

# 탭 관리
Cmd + T              # 새 탭
Cmd + W              # 탭 닫기
Cmd + 1-5            # 탭 이동

# 창 분할
Cmd + Shift + D      # 파일 diff 뷰어 (kitten)
Cmd + Shift + V      # 하단 분할

# 설정 다시 로드
Cmd + Shift + R      # kitty 설정 재로드

# kitten 통합 기능 (새로 추가됨)
Cmd + Shift + H      # 클립보드 히스토리 관리
Cmd + Shift + I      # 현재 폴더 이미지 갤러리 보기
Cmd + Shift + U      # 유니코드 문자 입력기

tmux 통합 단축키

# tmux 세션 관리 (kitty에서)
Cmd + Shift + N      # 새 tmux 세션
Cmd + Shift + A      # tmux 세션 연결/생성
Cmd + Shift + S      # tmux 세션 선택

# tmux 패널 이동 (kitty에서)
Cmd + Shift + 화살표  # tmux 패널 이동

# Fish shell 기능
Cmd + Shift + Z/X    # 이전/다음 프롬프트로 이동
Cmd + Shift + O      # 마지막 명령어 출력 보기
Ctrl + G             # 히스토리 검색 (fish에서)

tmux 기본 단축키

# Prefix: Ctrl + A
Ctrl + A, |          # 세로 분할
Ctrl + A, -          # 가로 분할
Ctrl + A, h/j/k/l    # 패널 이동 (vim 스타일)
Ctrl + A, r          # 설정 다시 로드

# Alt 키 조합 (Prefix 불필요)
Alt + 화살표          # 패널 이동
Shift + 좌우화살표    # 창 이동

💻 유용한 명령어

tmux 세션 관리

tm                   # tmux 시작
tma work             # 'work' 세션에 연결
tmn project          # 'project' 새 세션 생성
tml                  # 세션 목록 보기
tmk work             # 'work' 세션 종료

kitty 도구들

icat image.png       # 이미지 터미널에서 보기
kdiff file1 file2    # 파일 비교
ssh user@server      # kitty SSH (테마 동기화)
preview              # fzf 파일 미리보기

Fish 고급 기능

# fzf 통합
Ctrl + R             # 명령어 히스토리 검색
Ctrl + Alt + F       # 파일 검색
Ctrl + Alt + S       # git 상태 검색

# 자동 완성
Tab                  # 스마트 자동완성
Tab Tab              # 모든 옵션 보기

🐱 kitten 통합 기능

새로 추가된 kitten 기능들

# 키보드 단축키로 접근
Cmd + Shift + H      # 클립보드 히스토리 관리
Cmd + Shift + I      # 현재 폴더 이미지 갤러리
Cmd + Shift + U      # 유니코드 문자 입력기
Cmd + Shift + D      # 파일 diff 뷰어

# 터미널 명령어로 접근
img image.png        # 이미지 보기
imgls               # 폴더 내 이미지들 갤러리
clipboard           # 클립보드 히스토리
unicode             # 유니코드 입력
hgrep pattern files # 클릭 가능한 grep

kitten 활용 팁

• 이미지 갤러리: 디자인 작업시 폴더 내 이미지들을 빠르게 미리보기
• 클립보드 히스토리: 복사한 내용들을 기록해서 나중에 재사용
• diff 뷰어: 파일 비교를 터미널에서 깔끔하게
• 유니코드 입력: 특수문자나 이모지를 쉽게 입력

📁 설정 파일 위치

kitty 설정

~/.config/kitty/kitty.conf      # 메인 설정 파일
~/.config/kitty/dracula.conf    # Dracula 테마 파일

Fish 설정

~/.config/fish/config.fish      # Fish 메인 설정
~/.config/fish/fish_plugins     # 설치된 플러그인 목록

tmux 설정

~/.tmux.conf                    # tmux 설정 파일

🔧 설정 커스터마이징

테마 변경

이전 테마로 돌아가려면:

# kitty.conf에서
# include dracula.conf  # 이 줄을 주석 처리
# 그리고 기존 색상 설정들의 주석을 해제

한글 폰트 활성화

D2Coding을 한글에 사용하려면:

# kitty.conf에서 23번 줄 주석 해제
symbol_map U+AC00-U+D7A3,U+1100-U+11FF,U+3130-U+318F,U+A960-U+A97F,U+D7B0-U+D7FF,U+302E-U+302F D2Coding

폰트 크기 변경

# kitty.conf 9번 줄
font_size 17.0  # 원하는 크기로 변경

🚀 추가 최적화 아이디어

더 많은 Fish 플러그인

fisher install jethrokuan/z                    # 스마트 디렉토리 점프
fisher install franciscolourenco/bass          # Bash 스크립트 실행
fisher install edc/bass                        # 환경 변수 관리

추가 tmux 플러그인

# ~/.tmux.conf에 추가
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'tmux-plugins/tmux-resurrect'

기타 kitty 개선

• ✅ kitten 통합 완료 (클립보드, 이미지, diff, 유니코드)
• 추가 테마 설치 (Tokyo Night, Catppuccin 등)
• 더 많은 kitten 탐색 (session, transfer 등)

---

📝 노트

이 설정은 macOS와 kitty 0.42.2 버전을 기준으로 작성되었습니다. 다른 OS나 버전에서는 일부 설정이 다를 수 있습니다.

설정에 문제가 있거나 개선이 필요한 부분이 있다면 각 설정 파일을 개별적으로 수정할 수 있습니다.

Happy coding! 🎉