설정

셸, 글꼴, 화면 배치 등 자주 쓰는 환경을 내 작업 방식에 맞춰보세요. 설정 윈도우에서 항목을 바꾸거나 ~/.tasty/config.toml을 직접 편집할 수 있습니다. 키 조합과 색을 바꾸는 방법은 단축키와 테마에서 자세히 안내합니다.

설정 윈도우 열기

사이드바 맨 아래 설정 버튼을 누르거나 Ctrl+, 를 누릅니다. 같은 단축키를 한 번 더 누르면 설정 윈도우가 닫힙니다.

• 상단 탭 7개: 일반 · 터미널 · 외관 · 단축키 · 핸들러 · 기타 · 플러그인 .
• 왼쪽 목록은 그 탭의 섹션입니다. 위의 섹션 검색… 에 글자를 넣으면 목록이 걸러집니다. 탭을 바꾸면 검색어는 지워집니다.
• 저장 을 누르면 바꾼 설정을 화면에 적용하고 파일 저장을 시작합니다. 파일을 쓰는 동안에도 계속 작업할 수 있습니다. 취소 하면 편집한 내용은 버려집니다. 헤더에 닫기 버튼은 없습니다.
• 설정 윈도우가 열려 있는 동안 에이전트가 명령으로 바꾼 설정(입력 규칙, 원격 전송, 웹훅 외부 허용 등)은 저장 해도 그대로 남습니다. 저장은 이 윈도우에서 바꾼 항목만 덮어씁니다. 같은 항목을 양쪽에서 바꿨다면 이 윈도우의 값이 남습니다.
• 저장한 설정을 적용하지 못하면 오류 알림이 뜨고 설정은 그대로입니다. 화면에는 적용됐지만 config.toml 에 쓰지 못했다면 경고 알림이 뜹니다. 이때 바뀐 설정은 Tasty를 다시 시작하면 사라집니다.
• Tasty가 읽은 뒤 다른 프로그램이 config.toml을 바꾸면 그 파일을 덮어쓰지 않고 저장 실패를 알립니다. 외부에서 바꾼 설정을 읽으려면 Tasty를 다시 시작하세요.
• 처음 시작할 때 보정한 설정과 확인한 셸 경로는 함께 저장합니다. 저장 결과를 기다리는 동안 로딩 화면은 계속 갱신됩니다. 실행 중 저장이 대기 중이어도 새 윈도우는 이번 실행에 적용된 최신 설정을 사용합니다.
• 언어 는 저장 후 Tasty를 다시 시작해야 적용됩니다. 성능 설정은 저장한 뒤 새로 여는 터미널부터 적용되며, 이미 열린 터미널은 바로 바뀌지 않습니다.
• 숫자 칸은 입력해서 바꿉니다. 드래그해서 올리거나 내리는 칸은 없습니다. 입력 중에는 값을 자동으로 보정하지 않고, 칸을 떠나거나 Enter 를 누를 때 허용 범위 안으로 맞춰집니다 — 범위를 벗어난 값을 쳐 두면 칸 테두리가 경고 색으로 바뀌고 그 아래에 허용 범위와 실제로 저장될 값이 한 줄로 나옵니다.
• 정수 칸은 값 전체가 보이도록 값 길이에 맞춰 넓어지고, 입력하는 동안에도 글자마다 넓어집니다. 단위는 칸 뒤에 표시됩니다. 설정 파일에 범위보다 큰 값이 적혀 있어도 읽을 때 바꾸지 않고 그대로 보여 줍니다.
• 설정 윈도우를 아주 좁게 줄여 항목의 칸이 이름 옆에 들어가지 않으면, 그 항목만 이름 아래 줄로 칸이 내려갑니다. 다시 넓히면 옆으로 돌아옵니다.

탭별 항목

일반

재시작 시 서피스 내용 복원을 끄면 다음 실행부터 이전 터미널 내용이 돌아오지 않습니다. 이미 저장된 이전 내용도 다시 복원하지 않으며, 탭 배치와 작업 디렉터리는 그대로 복원됩니다. 닫은 탭을 되살릴 때(Ctrl+Shift+T)도 설정이 꺼져 있는 동안에는 터미널 내용을 넣지 않습니다.

원격 전송의 저장 폴더 옆 **찾아보기…**는 설정 안의 Tasty 폴더 피커를 엽니다. 선택한 하위 폴더 또는 현재 폴더를 폴더 선택으로 확정하면 입력칸만 바뀝니다. 설정의 저장을 눌러 적용하세요. 취소하거나 Esc를 누르면 폴더 값은 그대로입니다.

터미널

링크 클릭 수식키를 좌클릭 열기 끄기 로 두면 좌클릭으로 링크를 열지 않습니다. 수식키 없이 링크에 마우스를 올려 표시할 수 있고 링크 위 우클릭 메뉴는 계속 사용할 수 있습니다. 팝업이나 배너 위에서는 링크 표시가 차단될 수 있습니다. 마우스 캡처 항목의 의미는 터미널 다루기.

외관

폰트 설정은 일반 의 기본값이 터미널 · 마크다운 · 탐색기에 일괄 적용되고, 각 섹션에서 기본값 사용 을 끄면 그 종류만 다른 값을 씁니다. 폰트 DPI 스케일링 이 자동 이면 모니터가 달라도 글자의 물리 크기가 같고, 고정 이면 픽셀 크기가 같아 고해상도 모니터에서 글자가 작아집니다.

폰트 목록을 열면 맨 위 검색칸에 이름 일부를 입력해 거를 수 있고, 목록을 닫으면 검색어는 지워집니다. monospace (기본) 항목은 검색어와 관계없이 맨 위에 있어 언제든 기본 폰트로 돌아갈 수 있습니다. 설정 파일에 이 컴퓨터에 없는 폰트 이름이 적혀 있으면 그 이름이 그대로 표시되고 바뀌지 않습니다.

단축키

단축키 에서 다룹니다.

핸들러

파일을 열 때 “어떤 파일인지 식별” 하는 규칙과 “무엇으로 열지” 를 정하는 표입니다. 기본값으로도 마크다운 · 이미지 · HTML 은 알아서 열리므로 보통 손댈 일이 없습니다.

• 파일 확장자 매핑 — 같은 확장자를 여러 디텍터가 가져갈 때 우선순위.
• 파일 디텍터 — 확장자 · 경로 패턴으로 파일 종류를 식별하는 규칙. 목록은 디텍터를 시도하는 순서대로 보입니다. 사용자 규칙을 추가할 수 있고, 이미 있는 디텍터 id 로 추가하면 그 디텍터에 내 규칙을 더합니다. 삭제는 내가 더한 부분만 지우며 내장 · 플러그인 규칙은 남습니다. 변경은 저장할 때 적용되고 그 전에는 행마다 되돌리기로 취소할 수 있습니다.
• 파일 핸들러 — 식별된 종류를 어떤 서피스로 열지, 또는 OS 기본 앱으로 넘길지. 목록은 실행 순서입니다. priority 가 낮은 것이 먼저이고, 같으면 사용자 · 플러그인 · 기본 제공 순입니다.
• 훅 핸들러 — 훅 · 웹훅 이벤트가 왔을 때 실행할 셸 명령과 내부 동작 목록. 훅 · 알림 · 웹훅.

이 표는 config.toml 이 아니라 ~/.tasty/file-handlers.toml 과 ~/.tasty/hook-handlers.toml 에 저장됩니다.

기타

• 스크립트 — 단축키나 이벤트로 실행할 Lua 스크립트를 등록합니다 (Lua 스크립트). 파일 경로(예: ~/.tasty/scripts/my-script.lua)와 표시 이름을 넣고, 단축키는 단축키 > 스크립트 실행 에서 붙입니다. 등록 뒤 파일이 바뀌면 변경됨 표시가 붙고 다음 실행 때 확인을 묻습니다.
• 작업 파이프라인 — 작업 그래프의 report 에 남기는 기록의 크기 상한입니다. 기록 한 건 상한 을 넘는 기록은 잘리고, 회차 report 상한 을 넘는 기록은 저장하지 않고 개수만 셉니다. 앞의 값은 항상 뒤의 값보다 작아야 합니다 (작업 report).
• 이상 탐지 — 메모리 증가·반복 호출·호출 폭주의 알림 표시와 기준값을 바꿉니다. 정상 작업에서도 걸릴 수 있는 후보 신호입니다. 반복 호출은 응답 지연이 아니라 같은 호출의 반복 횟수를 셉니다. 알림을 꺼도 탐지와 기록은 계속되며 숫자는 편집할 수 있습니다. 저장한 값은 다음 판정부터 적용됩니다. 범위 밖 숫자는 Enter 또는 다른 칸으로 이동할 때 보정되고, 취소하면 편집 내용을 버립니다.
• Windows 에서는 Tastyrc 섹션이 추가됩니다.

플러그인

플러그인이 추가한 설정 페이지가 모입니다. 기본 설치 상태에서는 Claude Code 와 Codex 페이지가 있습니다 — 플러그인.

언어 추가하기 (언어팩)

Tasty 에 들어 있는 언어는 English · 한국어 · 日本語 셋입니다. 그 밖의 언어는 언어팩을 직접 두면 언어 목록에 함께 나타납니다.

언어팩 만들기

~/.tasty/lang/ 아래에 언어 코드 이름의 폴더를 만들고 그 안에 pack.toml 을 둡니다. 예를 들어 프랑스어라면 ~/.tasty/lang/fr/pack.toml 입니다.

[meta]
name = "Français"          # 언어 목록에 보일 이름 (생략하면 폴더 이름)

[font]                     # 필수 — 아래 넷 중 하나만
builtin = true             # Tasty 기본 글꼴로 충분한 문자만
# file = "fonts/x.ttf"     # 팩 폴더 안에 함께 둔 글꼴 파일
# family = "Noto Sans"     # 컴퓨터에 설치된 글꼴 이름
# candidates = ["fonts/x.ttf", "Noto Sans"]   # 위에서부터 차례로 시도

[button]                   # 여기서부터는 번역할 문구
ok = "OK"
cancel = "Annuler"

• [font] 은 생략할 수 없습니다. 문구만 있고 글꼴 지정이 없으면 화면에 글자가 □ 로 깨질 수 있어서, 팩을 만든 사람이 어느 글꼴로 볼지 밝히도록 했습니다.
• 선언한 글꼴은 UI 전체에 적용됩니다. file · family · candidates 로 밝힌 글꼴이 기본 글꼴 뒤에 더해져, 설정·팝업은 물론 플러그인 화면(클립보드 뷰어 · 마크다운 등)까지 그 언어의 글자가 함께 나옵니다. builtin = true 는 “기본 글꼴로 충분하니 더하지 않는다” 는 뜻입니다.
• 전부 번역하지 않아도 됩니다. 적지 않은 문구는 영어로 나옵니다. 값을 빈 문자열 ("")로 두는 것도 “번역하지 않음” 으로 보고 영어로 나옵니다 — 화면에 빈 칸이 생기지 않습니다.
• 문구의 이름([button] ok 같은 것)은 Tasty 에 들어 있는 언어 파일과 같은 짜임새입니다. 기존 언어 파일을 복사해서 시작하는 편이 빠릅니다.
• {} 가 들어 있는 문구는 실행할 때 값이 채워지는 자리입니다. 개수를 그대로 두어야 합니다 — 지우면 그 값이 사라지고, 더 넣으면 {} 가 화면에 그대로 보입니다.

터미널 명령의 도움말도 번역됩니다

tasty --help 처럼 터미널에서 보는 도움말도 고른 언어로 나옵니다. 언어팩에서는 [cli.help] 아래의 문구가 그 자리입니다.

[cli.help._root]
about = "Émulateur de terminal accéléré par GPU"

[cli.help._root.new]
about = "Créer une ressource"

• 여기서도 전부 번역하지 않아도 됩니다. 적지 않은 명령은 영어 설명이 그대로 나오고, 번역한 것과 섞여 보입니다.
• 도움말의 사용법·명령·옵션 제목, 기본값 안내와 인자 오류도 고른 언어로 표시됩니다. tasty help help와 플러그인의 help help도 같은 언어를 사용합니다. 인자 설명이 없는 플러그인에서도 기본값 안내는 표시됩니다. 명령 이름·옵션·허용 값은 그대로 사용합니다. 하위 파서가 제공한 상세 오류와 서버의 오류 원문은 영어로 남을 수 있습니다.
• 플러그인 명령의 설명과 인자 도움말도 아래의 플러그인 번역 파일에서 바꿀 수 있습니다. 예를 들어 한국어 Codex 도움말 제목은 ~/.tasty/lang/plugins/com.tasty.codex/ko.toml에 [codex.cli]와 desc = "나의 Codex 명령"을 넣어 바꿉니다. 번역 키가 없는 이전 플러그인은 기존 설명을 유지합니다.

고르기

설정 윈도우 › 일반 › 언어 목록에 팩이 함께 나옵니다. 고르고 저장 한 다음 Tasty 를 다시 시작하면 적용됩니다.

플러그인 문구 바꾸기

플러그인 설치 폴더를 고치지 않고도 문구를 덮어쓸 수 있습니다. 한국어라면 ~/.tasty/lang/plugins/com.tasty.clipboard-viewer/ko.toml에 다음처럼 적으세요.

[clipboard_viewer.command]
open_viewer = "내 클립보드 열기"

[clipboard_viewer.popup]
title = "내 클립보드"

플러그인의 도구 항목과 내부 화면이 같은 파일을 읽습니다. 폴더 이름은 플러그인 ID이며, 다른 플러그인을 바꾸려면 그 플러그인의 ID와 번역 항목 이름을 사용하세요. 새 언어팩 fr에서는 ~/.tasty/lang/fr/plugins/com.tasty.clipboard-viewer.toml에 둡니다. 먼저 fr/pack.toml을 만들고 그 언어를 선택해야 합니다.

설치본 영어 → 설치본 선택 언어 → 사용자 파일 순서로 덮습니다. 빈 값이나 빠진 항목은 앞 단계의 문구를 유지합니다. 파일이 잘못된 TOML이거나 2 MiB를 넘으면 무시하고 경고를 남깁니다. 수정 후 Tasty를 다시 시작하세요. 이 파일은 플러그인을 업그레이드해도 보존됩니다. 같은 플러그인 항목을 본체의 ko.toml이나 pack.toml에도 중복해서 넣지 마세요.

TASTY_HOME을 상대경로로 지정해 실행해도 플러그인은 Tasty를 실행한 디렉터리 기준의 사용자 번역을 읽습니다. 기본 번들 플러그인도 이 홈에서 기동하며, 사용자 번역에 없는 문구는 설치본 번역으로 표시됩니다.

이미 들어 있는 언어의 문구만 바꾸고 싶다면

폴더가 아니라 파일 하나를 둡니다 — ~/.tasty/lang/ko.toml 처럼. 적은 문구만 기본값을 덮어쓰며 [font] 도 필요 없습니다. 이 방식은 English · 한국어 · 日本語 세 언어에만 씁니다. 새 언어를 이 방식으로 두면 목록에 나타나지 않습니다.

값을 빈 문자열("")로 두면 언어팩과 마찬가지로 “바꾸지 않음” 으로 봅니다 — 원래 들어 있던 그 언어의 문구가 그대로 나오고, 화면에 빈 칸이 생기지 않습니다.

잘 안 될 때

• 목록에 안 보입니다 — 폴더 이름이 언어 코드인지, 그 안의 파일 이름이 정확히 pack.toml 인지, [font] 이 있는지 확인합니다. 설정 윈도우를 닫았다가 다시 엽니다 (목록은 윈도우를 열 때 한 번 읽습니다). pack.toml 은 2 MiB 를 넘을 수 없습니다 — 내장 언어 파일이 400 KiB 도 안 되므로 정상적인 번역은 여기 걸리지 않습니다.
• 영어로 뜨고 경고가 나옵니다 — 고른 언어의 팩을 찾지 못했거나 파일이 잘못됐다는 뜻입니다. 경고에 어느 경로를 찾았는지 나옵니다. 설정은 그대로 남으므로, 팩을 고쳐 두고 다시 시작하면 그 언어로 돌아옵니다.
• 글자가 □ 로 나오고 글꼴 경고가 뜹니다 — 팩과 문구는 실렸지만 [font] 이 가리키는 글꼴을 찾지 못했거나 열 수 없다는 뜻입니다. 문구는 그대로 나오고 글꼴만 안 붙습니다. file 경로(팩 폴더 기준)나 family 이름을 확인하고 다시 시작합니다.
• 자세한 사유는 ~/.tasty/debug.log 에 한 줄로 남습니다.

설정 파일 ~/.tasty/config.toml

일반 설정은 이 파일에 저장됩니다. 핸들러 표와 테마 파일 등은 위에서 설명한 별도 경로를 사용합니다. 없는 키는 기본값으로 읽히므로 필요한 것만 적어도 됩니다.

[general]
language = "ko"                  # "en" | "ko" | "ja"
close_behavior = "ask"           # "ask" | "minimize" | "quit"
wheel_line_scroll = 50.0         # 휠 한 칸이 스크롤하는 거리(pt), 10~200
restore_layout = true
restore_surface_content = true
scrollback_lines = 10000
inherit_cwd = true
confirm_close_running = true
link_click_modifier = "ctrl"     # "ctrl" | "alt" | "none"
click_to_move_cursor = true      # 셸 입력 줄을 클릭하면 커서를 그 위치로 옮김
allow_clipboard_read = false
bell_notification = true
workspace_categories_enabled = false
explorer_refresh_file_details = false  # 탐색기가 열린 폴더 파일의 크기·수정 시각 변경도 자동 반영
explorer_props_time_format = "minutes"  # "minutes" | "seconds" | "seconds_offset" — 속성 창의 시각 형식
mouse_capture_blacklist = ["htop"]
shell = ""                       # 비우면 자동 감지
startup_command = ""

[appearance]
theme = "mocha"                  # ~/.tasty/themes/<id>.toml
ui_scale = "medium"              # "small" | "medium" | "large" — 사이드바 폭도 이 값을 따름
ligatures = true
background_opacity = 1.0
active_tab_indicator = "underline"   # "underline" | "fill" | "dot"

[appearance.default_font]
font_family = ""
font_size = 14.0
line_height = 1.0
font_scale_mode = "auto"         # "auto" | "fixed"

[appearance.terminal_font]       # 비워 두면 default_font 를 따름
font_size = 15.0

[notification]
enabled = true
sound = false
coalesce_ms = 500

[accessibility]
reduced_motion = false

[modifier_hint]
enabled = true

[overlay]
toast_duration_ms = 2000

[performance]
targeted_pty_polling = true
scrollback_disk_swap = false
scrollback_disk_lines = 10000     # 디스크에 남길 줄 수, -1 이면 무제한

[remote_transfer]
dir = ""                         # 비우면 ~/.tasty/transfers/
max_mb = 500

[webhook]
allow_external = false           # true 면 다른 컴퓨터의 웹훅 호출도 받음(다음 시작부터)

[task_pipeline]
report_append_bytes = 1024       # 기록 한 건 상한, 64~65536
report_block_bytes = 16384       # 회차 report 상한, 128~131072, 기록 한 건 상한보다 커야 함

[anomaly_detection]
rss_surge_notify = true
rss_surge_samples = 5            # 3~20
rss_surge_min_mib = 256          # 0~65536 MiB
slow_loop_notify = false
slow_loop_window_secs = 300      # 30~3600
slow_loop_threshold = 20         # 2~10000
call_burst_notify = true
call_burst_window_secs = 60      # 1~600
call_burst_threshold = 1000      # 10~100000

[keybindings]
new_tab = ["alt+t"]              # 나머지는 keybindings.md

이상 탐지 기준은 이 파일에서 바꿉니다. 알림을 꺼도 탐지 기록은 남습니다. SlowLoop는 응답 시간을 재지 않고 정상 폴링에도 걸리므로 기본으로 기록만 남깁니다. RSS 증가 신호는 마지막 샘플이 최소 크기에 도달해야 합니다. 이어지는 RSS 증가 추세와 SlowLoop 반복 호출은 한 번만 기록하고, 알림을 다시 켜도 이전 기록을 소급해서 알리지 않습니다. 실행 중 기준을 바꾸어도 관측 상태를 유지합니다. 조회 기간이나 샘플 수를 줄이면 다음 확인에서 이력을 자르고, 늘려도 이미 버린 이력은 돌아오지 않습니다. 파일의 범위 밖 값은 이 절 전체를 기본값으로 되돌리고, 실행 중 잘못된 변경은 거절합니다.

• [terminal_input]에는 앱별 Shift+Enter 동작이 저장됩니다. 터미널 → 입력에서 설정하세요. 예를 들어 [[terminal_input.rules]]에 app = "claude", shift_enter_newline = true를 지정하면 Claude Code에 줄바꿈 문자를 보냅니다. initialized_defaults는 플러그인 기본값 적용 기록이므로 직접 수정하지 않아도 됩니다.
• [appearance] 아래에는 이 밖에도 테마 색 전체(theme_base)와 색상 탭에서 덮어쓴 값(theme_overrides)이 저장됩니다. 손으로 고치기보다 설정 윈도우를 쓰는 편이 안전합니다.
• [plugin_settings."com.tasty.html"] 처럼 플러그인 설정 페이지의 값은 플러그인 id 를 키로 한 절에 들어갑니다.
• Tasty는 실행 중에 이 파일을 감시하지 않습니다. 손으로 고친 값은 다음 시작 때 읽습니다. 실행 중 외부 변경이 감지되면 저장을 거절하고 파일을 보존합니다. 파일을 직접 편집할 때는 Tasty를 종료한 뒤 하세요.

원격 전송 항목만은 CLI 로도 읽고 쓸 수 있습니다.

tasty settings get-remote-transfer
tasty settings set-remote-transfer --dir ~/incoming --max-mb 1000

설정을 바꾸는 명령(set-remote-transfer, set-input-rule, tasty webhook allow-external 등)은 설정을 적용하고 config.toml 에 저장한 뒤에 결과를 출력합니다. 저장하지 못했으면 성공 대신 오류로 끝납니다. 이 경우 값은 이번 실행에만 적용됩니다.

~/.tasty 폴더에 있는 것

함께 살펴보기

• 단축키 — 기본 표 · 프리셋 · 녹화.
• 테마 — 테마 전환 · 색 덮어쓰기 · 직접 만들기.
• 플러그인 — 플러그인 설정 페이지와 관리 윈도우.