From 1d16521e1fd394142b1eb81f053a9589c8475da0 Mon Sep 17 00:00:00 2001 From: AshSgDe29071999 Date: Sun, 9 Aug 2026 10:39:50 +0530 Subject: [PATCH] docs: quickstart uses shipped fixture plus expected output shape Make first run copy-pasteable without a real Claude session, and show the stable fields readers should see. Fixes #1 --- README.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3b7eedd..a5e9899 100644 --- a/README.md +++ b/README.md @@ -26,8 +26,21 @@ deps), and upgrades to exact counts automatically when `tiktoken` is installed. pip install ctxlens-cli # core pip install "ctxlens-cli[tiktoken]" # optional exact token counts -ctxlens analyze session.jsonl -ctxlens report session.jsonl --html -o report.html +# From a clone, use the shipped fixture (no real session required): +ctxlens analyze tests/fixtures/claude_code_session.jsonl +``` + +Expected shape (numbers vary with tokenizer; structure is stable): + +```text +Source tests/fixtures/claude_code_session.jsonl +Format claude-code-jsonl +Tokens … Turns … High-water … +Waste … tokens (…%) +``` + +```bash +ctxlens report tests/fixtures/claude_code_session.jsonl --html -o report.html ctxlens diff before.jsonl after.jsonl ```