DDDFXYqiming/dsh-session-recap

When you come back to a session you left, a card above the composer recaps the current task, the most important progress and the next action, generated while you were away.

The trigger is deliberately conservative — every connected client must have been away at least idleMs (default 180000) and the last completed turn must also be that old, with at least minTurns (3) completed turns. The recap is stored in a plugin sidecar and shown as a card that disappears once the session advances; one recap is current per session, and starting a turn clears it. Defaults are 80 recent messages, a 400-character cap on the recap and a 24,000-character cap on the transcript, with provider and model settable as a pair or inherited from the session's last request; a thinking-model route spends the output budget on thinking too, so an empty first attempt is retried once with four times the tokens. /recap generates one on demand, and hostCommand: true serves profiles that have no web client. The recap follows the language of your own messages, not of pasted logs.

Sessions & Messages ★ 1
View on GitHub ↗

Install

dsh plugin --profile web add github:DDDFXYqiming/dsh-session-recap

The github: line the README documents as the install route. A git install runs the package prepare script and rebuilds lib/, which pnpm 10+ refuses until the profile allows it — the README gives the exact allowBuilds key. A tarball from pnpm pack installs without a build. Package name is @dsh-external/dsh-session-recap.

Compatibility

Node.js ^22.19.0 || >=24.0.0. Automatic recaps only cover interactive sessions you have visited, and every WebUI page must explicitly remain away: clients heartbeat every 20 seconds and an active client whose 45-second lease expires becomes unknown, pausing automatic recaps until it reports a state again. Focusing any page cancels scheduled and in-flight recaps across all sessions.

Details

Alternatives

xiaoshenming/dsh-session-surgeon · YeqingTang/dsh-session-flow · PolinniZhong/dsh-session-workbench

More plugins in Sessions & Messages

Browse more in Sessions & Messages

Guides for Sessions & Messages plugins