feat: integrate session summary hook for end-of-session analytics

[FlorianBruniaux]

Problem

RTK tracks token savings via rtk gain, but users must manually run it to see their savings. There's no automatic visibility into the value RTK provides at the end of each Claude Code session.

Meanwhile, 4 open issues on anthropics/claude-code request exactly this kind of session analytics — and Anthropic hasn't shipped anything:

• #1109 - Usage Metrics Visibility for Max Subscribers
• #18550 - Automatic Cost Tracking and Reporting
• #16373 - Auto-spawn subagents with persistent session summaries
• #22625 - Per-Subagent Token Usage Tracking

Existing Solution

A community-built Session Summary hook already solves this. It's a Claude Code SessionEnd hook (bash) that displays 15 configurable analytics sections at every session exit:

• Duration, tools, errors, files, git diff, LOC, models, cache, cost, RTK savings, ratio, thinking, context...
• RTK integration: captures baseline at SessionStart (rtk gain snapshot), computes per-session delta at SessionEnd
• Fully toggleable: if RTK isn't installed, the section is simply hidden
• Single dependency: jq
• Open source: claude-code-ultimate-guide/examples/hooks

How RTK integration works

1. SessionStart hook (rtk-baseline.sh): runs rtk gain > /tmp/rtk-baseline-<key>.txt
2. SessionEnd hook (session-summary.sh): reads baseline, runs rtk gain again, computes delta
3. Displays per-session savings: commands count, tokens saved, percentage

Note: The hook currently uses rtk gain text output. The --format json flag could enable more precise parsing.

Proposal

Option A: rtk install-hooks (recommended quick win)

New command that installs the SessionStart + SessionEnd hooks into ~/.claude/hooks/ and patches settings.json:

rtk install-hooks              # Install session summary hooks
rtk install-hooks --uninstall  # Remove them

Pros: One-command setup, leverages existing battle-tested hook code, minimal Rust changes
Cons: Bash dependency, external hook maintenance

Option B: rtk session-summary (native Rust)

RTK embeds the session summary logic natively. Pure Rust, no bash/jq dependency. Could hook into Claude Code's SessionEnd event.

Pros: No external dependencies, faster, tighter integration
Cons: Significant development effort, needs to replicate 15 sections of analytics

Option C: Documentation + reference (immediate)

Add a "Companion Tools" section to the README documenting the session summary hook as a recommended companion for automatic RTK savings visibility.

Pros: Zero code changes, immediate value, community attribution
Cons: Users must install manually, no tight integration

Option D: Bundle hook in repo

Copy the hook scripts into a hooks/ directory in the RTK repo, maintained in sync with upstream.

Pros: Single repo, discoverable
Cons: Sync maintenance burden, potential version drift

Recommendation

Phase 1 (now): Option C — document the hook in README as companion tool
Phase 2 (next): Option A — rtk install-hooks command for one-click setup
Phase 3 (roadmap): Option B — native Rust implementation for zero-dependency experience

References

• Session Summary hook: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/examples/hooks/bash/session-summary.sh
• RTK baseline hook: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/examples/hooks/bash/rtk-baseline.sh
• Config CLI: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/examples/hooks/bash/session-summary-config.sh
• Hook documentation: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/main/examples/hooks/README.md#session-summarysh-v3

[pszymkowiak]

wshm · Automated triage by AI

🔍 Automated Triage

✨ Category	feature
🟡 Priority	medium
🎯 Confidence	88%

Summary

Feature request to integrate session summary analytics hook into RTK via a new rtk install-hooks command or documentation; well-scoped proposal with phased implementation plan by the hook's original author.

📁 Relevant files

• README.md

---

Triaged automatically by wshm · This is an automated analysis, not a human review.

[FlorianBruniaux]

Status update: partial implementation exists.

src/analytics/session_cmd.rs provides a manual analytics command (SessionSummary struct, reads JSONL session logs). But the automatic end-of-session hook part described in this issue has not been implemented — no on_exit handler, no atexit-style trigger.

The manual command covers the analytics use case. The automatic hook trigger remains open.

[LukaszByczynski]

Hi, in this PR I have implemented collection of token savings, with the option to see gains per session. The session is injected via the --session-id option or by setting an environment variable. Additionally, I have extended hook registration to automatically inject the session ID from the agent