claude-code - 💡(How to fix) Fix [feature request] Configurable idle threshold for session recap auto-fire [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#55509Fetched 2026-05-03 04:51:32
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Participants
Timeline (top)
labeled ×3

The session recap (away summary) feature is very useful when returning to a session, but the auto-fire idle threshold appears to be fixed (a few minutes) and not user-configurable.

Root Cause

The session recap (away summary) feature is very useful when returning to a session, but the auto-fire idle threshold appears to be fixed (a few minutes) and not user-configurable.

RAW_BUFFERClick to expand / collapse

Summary

The session recap (away summary) feature is very useful when returning to a session, but the auto-fire idle threshold appears to be fixed (a few minutes) and not user-configurable.

Feature request

Add a configurable threshold so users can tune when auto-recap fires. e.g.:

  • awaySummaryIdleMinutes in settings.json (numeric, minutes)
  • or a CLAUDE_CODE_AWAY_SUMMARY_IDLE_MINUTES environment variable

Use case

I find recap genuinely valuable for context restoration after pauses, but my workflow benefits from quicker firing during medium pauses (1-3 min), not only long idles. Currently I have to type /recap manually for short pauses, which works, but the auto-trigger is the right pattern; it just needs tuning.

Current behavior (verified)

  • Toggle: /config -> Session recap, or awaySummaryEnabled: false in settings.json, or CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0
  • Manual: /recap
  • Threshold: not exposed

Environment

  • Claude Code 2.1.126
  • macOS 25.4.0 (Apple Silicon)
  • language: ja

Thanks for the feature — it is a great addition to long working sessions.

extent analysis

TL;DR

To address the issue, consider adding a configurable threshold for the auto-fire idle feature, such as an awaySummaryIdleMinutes setting or a CLAUDE_CODE_AWAY_SUMMARY_IDLE_MINUTES environment variable.

Guidance

  • Review the existing settings.json configuration to understand the current structure and potential locations for adding a new setting like awaySummaryIdleMinutes.
  • Investigate if there are any existing environment variables that could be leveraged or extended to include the idle threshold configuration, similar to CLAUDE_CODE_ENABLE_AWAY_SUMMARY.
  • Consider the implications of introducing a user-configurable threshold, including how it might affect the overall user experience and any potential edge cases that need to be handled.
  • Evaluate the feasibility of implementing this feature request in the current version of Claude Code (2.1.126) or if it would require updates to the underlying architecture.

Example

No specific code example is provided due to the lack of detailed implementation information in the issue.

Notes

The introduction of a configurable threshold would require careful consideration of the default value, the range of acceptable values, and how the feature interacts with other settings and environment variables.

Recommendation

Apply a workaround by manually using the /recap command for short pauses until the configurable threshold feature can be implemented, as this allows for some level of customization of the recap feature without waiting for a full implementation of the requested functionality.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [feature request] Configurable idle threshold for session recap auto-fire [1 participants]