Reference
Privacy and uninstall
What Deftty writes, what it connects to, how to remove it
No accounts, no telemetry, no third-party SDKs. Network access is limited to three things: the update feed, the Korean font download, and the Claude usage API with your own credentials.
Files
| Path | Contents |
|---|---|
~/.config/deftty/config.toml | Settings, created when you change something |
~/.config/deftty/session.json | Workspaces, windows, tabs, panes, Claude session ids |
~/.deftty/events/ | Claude hook events |
~/.deftty/sessions/, ~/.deftty/usage.json | Claude status line data |
~/.deftty/statusline-tee.sh, statusline-original.json | The status line wrapper and your original command |
~/.deftty/fonts/ | Downloaded fonts |
~/.deftty/deftty.log | App log |
Claude Code settings
In ~/.claude/settings.json:
- Five hooks, added at launch. The original file is backed up as
settings.json.deftty-backup. Withclaude-hooks = falsethey are not added, and any present are removed. - The
statusLinecommand is wrapped with the tee script at launch. This is not undone automatically.
Notification and keep-awake options live in the app defaults domain dev.ccamus.deftty. The keychain item "Claude Code-credentials" is read for usage, never written.
Reporting a problem
Report a Problem… in the app menu saves a diagnostic zip to your Desktop and opens the GitHub issue form. Issues are public.
- Filled into the form: app version, build and channel, macOS version, Mac model, Claude Code path and version, hook count and notification setting.
- In the zip:
report.txt(the above plus system language, welcome sheet state, and whether the previous run ended abnormally), the last 500 KB of the app log, crash reports from the last 14 days,config.toml, andsession.json(can be unchecked; it holds workspace paths and Claude session ids). Home directory paths are shortened to~. - The zip stays on your Mac until you attach it by dragging it into the issue. Whether to attach is your call.
Uninstall
An uninstall script is coming. Until then:
Add
claude-hooks = falseto~/.config/deftty/config.tomland launch Deftty once. This removes the hooks.Restore
statusLinein~/.claude/settings.jsonto the command in~/.deftty/statusline-original.json.Quit Deftty and move the app to the Trash.
Remove the data:
bashrm -rf ~/.config/deftty ~/.deftty defaults delete dev.ccamus.deftty
Note Do step 2 before step 4. The original command is inside ~/.deftty.
Last updated 2026-09-09, as of Deftty 0.2.12