Command reference ยท Claude Code
/recap
Generates a one-line summary of the current session on demand.
The /recap command generates an on-demand one-line summary of the current session. It complements the automatic recap feature that Claude Code shows by default when you return to the session after at least three minutes away with an unfocused terminal โ provided the session already has at least three conversation turns and the last recap wasn't immediately before. The automatic version runs in the background, so the summary is already ready by the time you switch back; it can be disabled via /config (the "Session recap" option) or forcibly disabled with CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0, for instance when telemetry is disabled entirely. In non-interactive sessions, no recap ever appears, neither automatic nor manual. After a /compact, Claude Code also no longer generates an introductory recap before continuing. /recap itself only provides this one line, not the full conversation history โ that's what /export is for, which saves the entire conversation as text.
โ WHEN TO USE IT?
Returning after a short break, before the automatic recap appears
Call /recap right after returning to the terminal to immediately see the current state
Sharing a quick status update with colleagues
Run /recap and share the one-line summary in the team chat
โ WHEN NOT TO?
Saving or sharing the full conversation history
/recap only provides one line, not the full text of the conversation
Better: Use /export to export the entire conversation as plain text
Expecting an automatic recap in a non-interactive (-p) session
Automatic recaps are always skipped in non-interactive mode
Better: Work in interactive mode, where the recap appears automatically or via manual /recap
SOURCES
- Claude Code docs (official) โ code.claude.com