[BUG] Auto session recap no longer fires on idle return (macOS Apple Terminal CLI, 2.1.193)
What happened
Auto session recap (the away-summary / awaySummary line that used to render on its own when a session sat untouched) no longer appears on macOS in Apple Terminal (plain CLI, real PTY). The feature used to auto-render on a quiet return from idle and silently stopped. Manual /recap works in a session that has messages.
Expected
After a session sits idle 5+ minutes and the user returns without typing, the session recap line should auto-render in the transcript.
Actual
Nothing renders on return from idle. No recap line, no error. Session recap is enabled.
What I've already ruled out
- Config:
/config→ Session recap: true. NoawaySummaryEnabledkey set in any settings layer (defaults on).CLAUDE_CODE_ENABLE_AWAY_SUMMARYunset;CLAUDE_CODE_ENABLE_REMOTE_RECAPunset. - Version:
2.1.193— past the known closed recap fixes (#48109 focus-mode fix in 2.1.110; #55023 Windows desktop and #55863 VSCode, both fixed 2026-06-16). None of those match this platform. - TUI mode: reproduces identically on both
/tui defaultand/tui fullscreen. - Not a child/background session: reproduced in a top-level
claudestarted directly in the terminal (not launched from anotherclaude;CLAUDE_CODE_CHILD_SESSIONunset). - Not the "started typing on return" skip: on return I did nothing and waited; recap still never fired.
- Manual
/recapworks when the session has prior messages (returns a summary), so the recap generator itself functions — only the auto-fire on idle path is dead.
Repro
claudedirectly in Apple Terminal (macOS), default settings.- Send one message, get a reply.
- Leave the session untouched 5+ minutes.
- Return to the terminal and do not type.
- Observe: no recap line auto-renders.
Environment
- Claude Code: 2.1.193 (Homebrew cask
claude-code@latest) - OS: macOS (Darwin 25.5.0)
- Terminal: Apple Terminal,
TERM=xterm-256color, no tmux TERM_PROGRAM=Apple_Terminal, entrypointcli- Settings of note:
awaySummaryEnabledunset (default on),tuitested bothdefaultandfullscreen
Question for maintainers
Is auto-recap gated on a focus-reporting (DECSET 1004) signal that Apple Terminal isn't delivering, or on a telemetry/remote-recap flag? If it depends on a focus-in event, a way to verify (debug log of focus transitions) or an opt-in "fire after idle regardless of focus event" would help.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗