Claude Code · Deftty

Deftty detects Claude Code running in its own panes and reads its hooks and status line. Claude Code in other terminals is ignored.

Notifications

Turn on "Claude notifications" in Settings (⌘,). Deftty adds five hooks to ~/.claude/settings.json and backs up the original as settings.json.deftty-backup. Turning it off removes them.

Hook	Used for
`Stop`	Notification when the response finishes, pane state to Idle
`Notification`	Notification when Claude Code needs input or permission, pane state to Needs input
`UserPromptSubmit`	Pane state to Working
`SessionStart`	Instant detection, session id for resume
`SessionEnd`	Clears the pane state

Click a notification to jump to that pane. Notifications are skipped while the pane is visible unless you enable "Notify even while the pane is visible". Sound plays only when Claude Code is waiting for input.

Claude Code finishes, macOS notifies, one click lands on the pane

Pane status

Each pane header shows the path, git branch, and for Claude Code the model, context usage and state: Working, Needs input or Idle. The bottom bar counts the panes in each state for the current workspace. With notifications off it shows the number of Claude Code sessions instead. Move the header to the bottom bar or hide it with pane-info.

Working, needs-input and idle panes, each with model and context

Usage

The bottom bar shows the session and weekly limits, turning amber at 70% and red at 85%. Click to see how long until they reset. The context percentage in the pane header uses the same thresholds.

To read them, Deftty wraps the Claude Code statusLine command in ~/.claude/settings.json with ~/.deftty/statusline-tee.sh at launch. Your original status line keeps running. Weekly model limits come from the Claude usage API using your own credentials, at launch and every 30 minutes after that.

Session resume

After a restart every Claude Code pane has claude --resume <id> typed in, waiting for Enter. To run it automatically:

toml

claude-auto-resume = true

Quit and relaunch. Every Claude pane has claude --resume ready

Shift+Enter

Shift+Enter inserts a newline in the Claude Code prompt instead of submitting. Deftty sets TERM_PROGRAM=Deftty so Claude Code knows the newline is supported.

Keep awake

The ☕ chip in the bottom bar keeps the Mac awake for 30 minutes to 24 hours, or indefinitely. The popover can also let the display sleep and notify you when the time runs out. The setting survives quitting Deftty, and a timed run comes back with the time it had left. Closing the lid still puts the Mac to sleep, unless an external display and power are connected.

Limits in the bottom bar and the ☕ keep-awake switch