설정

imux는 Ghostty 설정 파일에서 구성을 읽어오므로, Ghostty에서 이전하는 경우 익숙한 옵션을 사용할 수 있습니다.

설정 파일 위치

imux는 다음 위치에서 설정을 순서대로 찾습니다:

1. ~/.config/ghostty/config
2. ~/Library/Application Support/com.mitchellh.ghostty/config

설정 파일이 없으면 생성하세요:

mkdir -p ~/.config/ghostty
touch ~/.config/ghostty/config

외관

글꼴

font-family = JetBrains Mono
font-size = 14

색상

# Theme (or use individual colors below)
theme = Dracula

# Custom colors
background = #1e1e2e
foreground = #cdd6f4
cursor-color = #f5e0dc
cursor-text = #1e1e2e
selection-background = #585b70
selection-foreground = #cdd6f4

분할 패널

# Opacity for unfocused splits (0.0 to 1.0)
unfocused-split-opacity = 0.7

# Fill color for unfocused splits
unfocused-split-fill = #1e1e2e

# Divider color between splits
split-divider-color = #45475a

동작

스크롤백

# Number of lines to keep in scrollback buffer
scrollback-limit = 10000

작업 디렉토리

# Default directory for new terminals
working-directory = ~/Projects

앱 설정

인앱 설정은 imux > 설정(⌘,)에서 사용할 수 있습니다:

테마 모드

• 시스템: macOS 외관 따르기
• 라이트: 항상 라이트 모드
• 다크: 항상 다크 모드

자동화 모드

소켓 접근 수준 제어:

• 끄기: 소켓 제어 없음 (가장 안전)
• imux 프로세스만: imux 터미널 내에서 시작된 프로세스만 연결 허용
• allowAll: 모든 로컬 프로세스의 연결 허용 (ICC_SOCKET_MODE=allowAll, 환경 변수 오버라이드만)

브라우저 링크 동작

설정 > 브라우저에서 imux는 서로 다른 목적의 두 가지 호스트 목록을 제공합니다:

• 내장 브라우저에서 열 호스트: 터미널 출력에서 클릭한 링크에 적용됩니다. 이 목록의 호스트는 imux에서 열리고, 다른 호스트는 기본 브라우저에서 열립니다. 줄당 하나의 호스트 또는 와일드카드를 지원합니다(예: example.com, *.internal.example).
• 내장 브라우저에서 허용되는 HTTP 호스트: HTTP(비 HTTPS) URL에만 적용됩니다. 이 목록의 호스트는 경고 프롬프트 없이 imux에서 열 수 있습니다. 기본값에는 localhost, 127.0.0.1, ::1, 0.0.0.0, *.localtest.me가 포함됩니다.

Setup readiness

imux readiness indicators are the operator checklist before a long agent or remote workflow starts. They summarize whether the app can find the expected CLI tools, saved provider profiles, notification hooks, workspace folder, remote connection, and browser or source-control context.

• Fix missing provider profiles before asking the supervisor to plan work.
• Confirm agent CLIs run both in a normal shell and inside an imux terminal.
• Use notification hook warnings as setup debt, not as proof that the task cannot launch.

예시 설정

# Font
font-family = SF Mono
font-size = 13

# Colors
theme = One Dark

# Scrollback
scrollback-limit = 50000

# Splits
unfocused-split-opacity = 0.85
split-divider-color = #3e4451

# Working directory
working-directory = ~/code