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

PathContents
~/.config/deftty/config.tomlSettings, created when you change something
~/.config/deftty/session.jsonWorkspaces, windows, tabs, panes, Claude session ids
~/.deftty/events/Claude hook events
~/.deftty/sessions/, ~/.deftty/usage.jsonClaude status line data
~/.deftty/statusline-tee.sh, statusline-original.jsonThe status line wrapper and your original command
~/.deftty/fonts/Downloaded fonts
~/.deftty/deftty.logApp log

Claude Code settings

In ~/.claude/settings.json:

  • Five hooks, added at launch. The original file is backed up as settings.json.deftty-backup. With claude-hooks = false they are not added, and any present are removed.
  • The statusLine command 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, and session.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:

  1. Add claude-hooks = false to ~/.config/deftty/config.toml and launch Deftty once. This removes the hooks.

  2. Restore statusLine in ~/.claude/settings.json to the command in ~/.deftty/statusline-original.json.

  3. Quit Deftty and move the app to the Trash.

  4. Remove the data:

    bash
    rm -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