Full clean

Removes every trace of TokenEater: processes, preferences, caches, widget caches and the app. Run it when something stays broken, then reinstall.

Connection problem only? Try Settings -> Providers -> Reset connection first: it keeps your settings. The full clean erases every preference, Studio layouts and themes included.

The script

Paste it in Terminal, all at once or step by step.

bash
# 1. Kill processes
killall TokenEater NotificationCenter chronod cfprefsd 2>/dev/null; sleep 1

# 2. Remove preferences
defaults delete com.tokeneater.app 2>/dev/null
defaults delete com.claudeusagewidget.app 2>/dev/null
rm -f ~/Library/Preferences/com.tokeneater.app.plist
rm -f ~/Library/Preferences/com.claudeusagewidget.app.plist

# 3. Clean sandbox containers
for c in com.tokeneater.app com.tokeneater.app.widget com.claudeusagewidget.app com.claudeusagewidget.app.widget; do
    d="$HOME/Library/Containers/$c/Data"
    [ -d "$d" ] && rm -rf "$d/Library/Preferences/"* "$d/Library/Caches/"* "$d/Library/Application Support/"* "$d/tmp/"* 2>/dev/null
done

# 4. Remove shared data and caches
rm -rf ~/Library/Application\ Support/com.tokeneater.shared
rm -rf ~/Library/Application\ Support/com.claudeusagewidget.shared
rm -rf ~/Library/Caches/com.tokeneater.app
rm -rf ~/Library/Group\ Containers/group.com.claudeusagewidget.shared

# 5. Remove WidgetKit caches (critical: macOS keeps old widget binaries here)
TMPBASE=$(getconf DARWIN_USER_TEMP_DIR)
CACHEBASE=$(getconf DARWIN_USER_CACHE_DIR)
USERBASE=$(getconf DARWIN_USER_DIR)
rm -rf "${TMPBASE}com.apple.chrono" "${CACHEBASE}com.apple.chrono" "${USERBASE}com.apple.chrono" 2>/dev/null
rm -rf "${CACHEBASE}com.tokeneater.app" "${CACHEBASE}com.claudeusagewidget.app" 2>/dev/null

# 6. Unregister widget plugins
pluginkit -r -i com.tokeneater.app.widget 2>/dev/null
pluginkit -r -i com.claudeusagewidget.app.widget 2>/dev/null

# 7. Remove the app
rm -rf /Applications/TokenEater.app
  • A few Operation not permitted errors on container metadata are normal: the data is still cleaned.
  • Your provider logins stay (the Claude Code Keychain item, ~/.claude, ~/.codex/auth.json): you remain signed in to Claude Code and Codex.

After cleaning

  1. Reinstall: the latest DMG, or brew reinstall --cask tokeneater if Homebrew installed it before (brew still lists the cask). Otherwise, use the Homebrew commands from Installation.
  2. Remove your old widgets and add new ones: right-click the desktop -> Edit Widgets -> search TokenEater.