Start
Getting started
Requirements, install, first run, updates
Requirements
| Mac | Apple Silicon |
| macOS | 13 or later |
| Shell | zsh, started as a login shell |
| Claude Code | Optional. Adds notifications, pane status and session resume |
There is no Intel build.
Install
- Download the DMG.
- Drag Deftty to Applications.
- Open it from Applications.
The app and the DMG are notarized, so Gatekeeper opens the app without a warning. Homebrew is coming.
First run
Deftty opens one window with a sidebar, a tab bar holding a shell, and a bottom bar. The default workspace is called "일반" (General) and has no folder. Press + in the sidebar and pick a project folder to create a workspace.
Two things are off until you turn them on in Settings (⌘,):
- Korean font. Press Install next to Noto Sans CJK KR. Skip it if you never type CJK.
- Claude notifications. Turn on "Claude notifications". Deftty asks for notification permission and adds its hooks to
~/.claude/settings.json. See Claude Code.
Update
Updates arrive through Sparkle. Use Check for Updates… in the app menu. On first launch Sparkle asks whether to check automatically. The current version is in About Deftty.
To remove Deftty completely, follow Privacy and uninstall.
Last updated 2026-09-09, as of Deftty 0.2.6