From a5896fe2e28eb1e9ff9affe5d47ccd443bee5fc2 Mon Sep 17 00:00:00 2001 From: Elvis Claros Castro Date: Sat, 3 Oct 2026 19:47:45 -0300 Subject: Use the /rename title, mark compactions, count active time A title set with /rename (custom-title) now wins over Claude's. The summary Claude Code leaves when the context is compacted is a block of its own ("c"), shown as a "context compacted here" mark instead of a message of yours, and not counted. Duration is active time: pauses over 30 minutes between messages are left out. --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 4913fcf..d077269 100644 --- a/README.md +++ b/README.md @@ -292,10 +292,17 @@ about 95% of the bytes on disk and almost none of the meaning. A few details worth knowing: -- **Titles.** Claude generates one during the session (`ai-title` events); the - most recent wins. Without one, the first thing you typed is used instead — +- **Titles.** The one you set with `/rename` wins (`custom-title` events); + otherwise the one Claude generates during the session (`ai-title`), the most + recent of each. Without either, the first thing you typed is used instead — which is visible, because it starts in lowercase or reads like a loose question. +- **Compaction.** When the context runs out (or on `/compact`) Claude Code + replaces the earlier conversation with a summary. That summary is shown as a + "context compacted here" mark, not as a message of yours, and is not counted. +- **Duration** is active time: the gaps between messages, leaving out pauses + longer than 30 minutes. A session resumed over several days does not count + the days in between. - **Empty sessions** were opened but never received a message: a cancelled `/resume`, a `/login`. - **Non-interactive** sessions are `claude -p` with something piped into stdin — @@ -330,16 +337,16 @@ Each session in `s`: | `p` | Project path (`cwd`). | | `b` | Git branch. | | `t` | Title. | -| `ai` | `true` if Claude generated the title. | +| `ai` | `true` if the title was set with `/rename` or generated by Claude. | | `n` | `true` if it looks like a non-interactive `claude -p`. | | `e` | `true` if the session has no messages. | | `i` | `true` if `p` was inferred from a sibling session. | | `f` / `l` | First and last event timestamps (ISO 8601). | -| `d` | Duration in minutes. | +| `d` | Active minutes (pauses over 30 minutes left out). | | `u` / `a` | Message counts, yours / Claude's. | | `k` | File size in KB. | | `v` | Claude Code version. | -| `c` | Transcript: `[{"r": "u"|"a"|"t", "x": text}]`. | +| `c` | Transcript: `[{"r": "u"|"a"|"t"|"c", "x": text}]`; `t` is a tool call, `c` a compaction summary. | Each memory in `m`: -- cgit v1.2.3