| name | ghostty-setup |
| description | Configure and troubleshoot Ghostty terminal settings with a safe, repeatable workflow for themes, profiles, accessibility/readability, and include chains. Use when Codex needs to create, update, or debug Ghostty config files (for example `config`, `themes/*.conf`, `profiles/*.conf`), adjust contrast/font/cursor/padding behavior, or switch and verify theme/profile setups. |
Ghostty Setup
Overview
Ghostty ์ค์ ์ ์์ ํ๊ฒ ๋ณ๊ฒฝํ๊ณ ๊ฒ์ฆํ๋ ํ์ค ์ ์ฐจ๋ฅผ ์ ๊ณตํ๊ธฐ.
ํ
๋ง/ํ๋กํ/๊ฐ๋
์ฑ ์ต์
์ ์์ ํ ๋ ๋ณ๊ฒฝ ๋ฒ์๋ฅผ ์ต์ํํ๊ณ ํ๊ท๋ฅผ ๋ฐฉ์งํ๊ธฐ.
Quick Start
- ์์ ๋์ ํ์ผ๊ณผ include ์ฒด์ธ์ ๋จผ์ ์๋ณํ๊ธฐ.
- ์ฌ์ฉ์ ์๊ตฌ๋ฅผ ์ต์
๋จ์๋ก ๋ถํดํด ๋ณ๊ฒฝ์์ ํ์ ํ๊ธฐ.
- ํ์ํ ์ต์
๋ง ์์ ํ๊ณ ๊ด๋ จ ํ์ผ๋ง ๊ฒ์ฆํ๊ธฐ.
- ๊ฒฐ๊ณผ์ ๋กค๋ฐฑ ๋ฐฉ๋ฒ์ ํจ๊ป ๋ณด๊ณ ํ๊ธฐ.
์์ธ ์ ์ฐจ๋ references/workflow.md๋ฅผ ์ฝ๊ธฐ.
์ต์
๋ณ ์๋ฏธ์ ์ฃผ์์ ์ references/options-map.md๋ฅผ ์ฝ๊ธฐ.
Workflow
1) ํ์ฌ ์ํ ํ์
ํ๊ธฐ
- Ghostty ์ค์ ๋ฃจํธ๋ฅผ ํ์ธํ๊ธฐ (
~/.config/ghostty ๋๋ ์์
๋๋ ํฐ๋ฆฌ).
- ์ํธ๋ฆฌ ํ์ผ(
config)๊ณผ config-file include ์ฒด์ธ์ ์ถ์ ํ๊ธฐ.
- ๋ณ๊ฒฝ ๋์ ํ์ผ์ ํ์ฌ ๊ฐ์ ํ์ธํ๊ธฐ.
2) ๋ณ๊ฒฝ ๊ณํ ํ์ ํ๊ธฐ
- ์์ฒญ์ ๊ธฐ๋ฅ ๋จ์๋ก ๋ถํดํ๊ธฐ:
- ๊ฐ๋
์ฑ:
font-size, minimum-contrast, ์ ํ ์์ญ ๋๋น
- ์๊ฐ ์คํ์ผ:
background, foreground, ANSI palette
- ์กฐ์๊ฐ:
cursor-style, cursor-style-blink, padding
- ๊ตฌ์ฑ ๊ตฌ์กฐ: profile/theme ๋ถ๋ฆฌ, include ์์
- ๊ธฐ์กด ์ค์ ์ ์ ์งํ ๊ฐ๊ณผ ๋ฎ์ด์ธ ๊ฐ์ ๊ตฌ๋ถํ๊ธฐ.
- ํ ๋ฒ์ ํ๋์ ๋ชฉํ(์: ๋๋น ๊ฐ์ )๋ง ์ฐ์ ์ ์ฉํ๊ธฐ.
3) ํ์ผ ์์ ํ๊ธฐ
- ๊ณตํต๊ฐ์ base profile์ ๋๊ณ , ํ๊ฒฝ๋ณ ๊ฐ์ active profile/theme๋ก ๋ถ๋ฆฌํ๊ธฐ.
- ์ค๋ณต ์ ์ธ์ ์ค์ด๊ณ ์ ์ธ ์ฐ์ ์์๊ฐ ๋๋ฌ๋๊ฒ ์ ๋ฆฌํ๊ธฐ.
- ์๋ฏธ ์๋ ๋๊ท๋ชจ ์ฌ์ ๋ ฌ์ ํผํ๊ณ , ํ์ํ ๋ผ์ธ๋ง ์์ ํ๊ธฐ.
4) ๊ฒ์ฆํ๊ธฐ
- include ๊ฒฝ๋ก ์คํ์, ํ์ผ ์กด์ฌ ์ฌ๋ถ, ์ํ ์ฐธ์กฐ ์ํ์ ์ ๊ฒํ๊ธฐ.
- ๋์ผ ์ต์
์ ์ค๋ณต ์ ์ธ ์ ์ต์ข
์ ์ฉ ์์น๋ฅผ ํ์ธํ๊ธฐ.
- ์ฌ์ฉ์๊ฐ ์ฆ์ ํ์ธํ ์ ์๋ ๊ฒ์ฆ ์ ์ฐจ(์ฌ๋ก๋, ์๊ฐ ํ์ธ ํญ๋ชฉ)๋ฅผ ์ ๊ณตํ๊ธฐ.
5) ๊ฒฐ๊ณผ ๋ณด๊ณ ํ๊ธฐ
- ๋ณ๊ฒฝ ํ์ผ ๋ชฉ๋ก๊ณผ ํต์ฌ diff ์๋๋ฅผ ์์ฝํ๊ธฐ.
- ํ์ธํด์ผ ํ ๋์(์: ์ปค์ ๊น๋นก์, ์ ํ ์์ญ ๋๋น)์ ์ฒดํฌ๋ฆฌ์คํธ๋ก ์ ์ํ๊ธฐ.
- ๋ฌธ์ ๋ฐ์ ์ ๋๋๋ฆด ํ์ผ/๋ผ์ธ ๋จ์๋ฅผ ์ ๊ณตํ๊ธฐ.
Task Patterns
๊ฐ๋
์ฑ/์ ๊ทผ์ฑ ์กฐ์
- ๋ฐฐ๊ฒฝ/์ ๊ฒฝ ๋๋น์
minimum-contrast๋ฅผ ํจ๊ป ๋ค๋ฃจ๊ธฐ.
- ๊ธ์ ํฌ๊ธฐ, ์ปค์ ํํ, ์ ํ ์์ญ ์์์ ๋ฌถ์ด์ ์กฐ์ ํ๊ธฐ.
- ์ ์๊ทน ๋ชจ๋(์ง์ ๋ฐฐ๊ฒฝ)์ ๊ณ ๋๋น ๋ผ์ดํธ ๋ชจ๋๋ฅผ ๋ถ๋ฆฌ ์ ๊ณตํ๊ธฐ.
ํ
๋ง ์ ํ
- theme ํ์ผ์ ๋
๋ฆฝ์ ์ผ๋ก ์ ์งํ๊ณ profile์์ ์ ํ๋ง ๋ฐ๊พธ๊ธฐ.
- palette ์ ์ฒด ํค์ ํจ๊ป ์กฐ์ ํด ANSI ์๋ง ํ์ง ์๊ฒ ๊ด๋ฆฌํ๊ธฐ.
profile ๊ตฌ์กฐ ์ ๋ฆฌ
config -> profiles/*.conf -> themes/*.conf ํํ๋ก ๊ณ์ธตํํ๊ธฐ.
- ๊ณตํต๊ฐ๊ณผ ๋ณ๋๊ฐ์ ๋ถ๋ฆฌํด ์ฌ์ฌ์ฉ์ฑ๊ณผ ๋กค๋ฐฑ ์ฉ์ด์ฑ์ ํ๋ณดํ๊ธฐ.
๋ฌธ์ ํด๊ฒฐ
- "๋ณ๊ฒฝ์ด ์ ๋จน๋๋ค" ์์ฒญ ์ include ์์์ ๋์ผ ํค ์ค๋ณต์ ๋จผ์ ์ ๊ฒํ๊ธฐ.
- "๋์ด ํผ๋กํ๋ค" ์์ฒญ ์ contrast/size/cursor/selection์ ์ฐ์ ์กฐ์ ํ๊ธฐ.
Output Contract
- ํญ์ ๋ค์์ ํฌํจํด ์๋ตํ๊ธฐ:
- ๋ณ๊ฒฝ/์ ๊ฒํ ํ์ผ ๊ฒฝ๋ก
- ์ ์ฉํ ํต์ฌ ์ต์
๊ณผ ์ด์
- ์ฌ์ฉ์๊ฐ ๋ฐ๋ก ์คํํ ๊ฒ์ฆ ๋จ๊ณ
- ๊ฐ์ ํ์ ํ ์ ์์ผ๋ฉด ์์ ์ถ์ ๋์ ํ์ธ ์ง๋ฌธ์ ์ต์ ๋จ์๋ก ์์ฒญํ๊ธฐ.