aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorElvis Claros Castro <elvis@claros.ar>2026-10-03 19:47:45 -0300
committerElvis Claros Castro <elvis@claros.ar>2026-10-03 19:47:45 -0300
commita5896fe2e28eb1e9ff9affe5d47ccd443bee5fc2 (patch)
treed76155b2c6aed9b905fe1b04094b879420964177 /README.md
parent60c586001cf4d21ef1351be8c8ad7a269a6f005a (diff)
downloadclaude-logbook-a5896fe2e28eb1e9ff9affe5d47ccd443bee5fc2.tar.gz
claude-logbook-a5896fe2e28eb1e9ff9affe5d47ccd443bee5fc2.zip
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.
Diffstat (limited to 'README.md')
-rw-r--r--README.md17
1 files changed, 12 insertions, 5 deletions
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`: