[BUG] Auto session recap no longer fires on idle return (macOS Apple Terminal CLI, 2.1.193)

Open 💬 3 comments Opened Jun 26, 2026 by timharsch

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: /configSession recap: true. No awaySummaryEnabled key set in any settings layer (defaults on). CLAUDE_CODE_ENABLE_AWAY_SUMMARY unset; CLAUDE_CODE_ENABLE_REMOTE_RECAP unset.
  • 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 default and /tui fullscreen.
  • Not a child/background session: reproduced in a top-level claude started directly in the terminal (not launched from another claude; CLAUDE_CODE_CHILD_SESSION unset).
  • Not the "started typing on return" skip: on return I did nothing and waited; recap still never fired.
  • Manual /recap works 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

  1. claude directly in Apple Terminal (macOS), default settings.
  2. Send one message, get a reply.
  3. Leave the session untouched 5+ minutes.
  4. Return to the terminal and do not type.
  5. 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, entrypoint cli
  • Settings of note: awaySummaryEnabled unset (default on), tui tested both default and fullscreen

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.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗