context-carwash 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.9
+
+- Friendlier README wording.
+
 ## 0.1.8
 
 - Shorter, clearer README.

package/README.md

@@ -5,33 +5,36 @@ Context Carwash adds a line to Claude Code in your terminal that:
 1. Shows the current conversation's context size.
 2. Lets you compress your context and start a new session without losing the important details.
 
+Pretty simple app, but I've found it helpful. Everything is local, but you can share your token savings anonymously with me if you'd like with `npx context-carwash stats --share`.
+
 ## Install
 
-Requires Node 18 or later.
+You'll need Node 18 or later.
 
 ```sh
-npx context-carwash preview     # see sample meters, nothing installed
-npx context-carwash install     # lists what it will change, then asks
+npx context-carwash install
 ```
 
-Then start a new Claude Code session. To update later, run `npx context-carwash@latest install`. You don't need to watch for updates: a line under the meter tells you when there's a new version.
+It shows you what it's going to change and asks before doing anything. Then start a new Claude Code session and you're set.
+
+When there's a new version, a line under the meter will tell you. To update, run `npx context-carwash@latest install`.
 
-The installer adds a status line and three hooks to `~/.claude/settings.json`, after anything you already have there, and adds the `/wash` command at `~/.claude/skills/wash`.
+Under the hood, it adds a status line and three hooks to `~/.claude/settings.json` (after whatever you already have there) and a `/wash` command in `~/.claude/skills/wash`.
 
-## The meter
+## The Meter
 
 ```text
 session context ~136k  [██████████░░░░░]  /wash to compress & save context, then /clear keeps compressed context
 ```
 
-The number is how many tokens the conversation is using, as estimated by Claude Code. The bar shows how full the context window is and changes colour as it fills. In narrow windows the text gets shorter. The meter never does anything on its own.
+The number is roughly how many tokens your conversation is using (Claude Code's estimate). The bar shows how full the context window is and changes colour as it fills up. In a narrow window the text shortens to fit. It's just a meter, so it never does anything on its own.
 
 ## /wash
 
-1. Type `/wash`. Claude writes a short brief: what you're doing, where things stand, and what to do next. The status line changes to `Brief ready ✓`.
-2. Type `/clear`. The new session starts with that brief already loaded.
+1. Type `/wash`. Claude writes a short brief: what you're working on, where things stand, and what's next. The status line switches to `Brief ready ✓`.
+2. Type `/clear`. Your new session starts with the brief already loaded.
 
-Your old conversation stays in `/resume`.
+Your old conversation isn't gone. You can still find it in `/resume`.
 
 | Command | What it does |
 |---|---|
@@ -44,11 +47,13 @@ Your old conversation stays in `/resume`.
 | `/wash stats` | How much context your washes have saved |
 | `/wash help` | Explain the meter and these options |
 
-- Words after the level tell Claude what to focus on: `/wash mid focus on the failing test`.
-- A `/clear` with no brief ready is a normal clear.
-- Writing a brief is an ordinary Claude reply, so it uses tokens. `help`, `discard` and `load` don't.
-- Each level has a size limit based on how big the conversation is. `/wash help` shows them.
-- Closed the terminal before `/clear`? Start `claude` in the same folder and the brief loads. If more than one is waiting, you're shown which ones, with the `/wash load <id>` to pick one.
+A few things worth knowing:
+
+- You can tell Claude what to focus on: `/wash mid focus on the failing test`.
+- If you `/clear` without a brief ready, it's just a normal clear.
+- Writing a brief is a normal Claude reply, so it uses some tokens. `help`, `discard` and `load` are free.
+- Bigger conversations get bigger briefs. `/wash help` shows the size limit for each level.
+- Closed the terminal before you got to `/clear`? Run `claude` in the same folder and your brief loads. If there's more than one waiting, it'll list them so you can pick with `/wash load <id>`.
 - Briefs expire after 48 hours.
 
 ## Stats
@@ -68,9 +73,9 @@ Carwash stats, since 3 Oct 2026 (12 days)
   Net saved                   ~20M tokens
 ```
 
-Every request to Claude re-sends the whole conversation. After a wash, each request starts from the small brief instead, so Carwash counts the requests you actually made and adds up the difference. Claude charges about a tenth for repeated context, so the money saved is roughly a tenth of these numbers. `/wash stats` shows the same inside Claude Code.
+Every request to Claude sends the whole conversation again. After a wash, each request starts from the small brief instead, so Carwash counts the requests you actually made and adds up the difference. Claude charges about a tenth of the price for repeated context, so in dollars you're saving roughly a tenth of these numbers. You can also see this inside Claude Code with `/wash stats`.
 
-`npx context-carwash stats --share` sends your anonymous totals, but only after showing you exactly what it will send and you say yes.
+If you run `stats --share`, it shows you exactly what it would send before asking.
 
 ## Something not working?
 
@@ -78,11 +83,11 @@ Every request to Claude re-sends the whole conversation. After a wash, each requ
 npx context-carwash doctor
 ```
 
-This checks that everything is still installed and working, and shows your versions and recent errors. Paste the output into a [new issue](https://github.com/Spobi/context-carwash/issues/new). Issues are public, and errors can include folder names, so look it over first.
+This checks that everything's still installed and working, and shows your versions and any recent errors. Paste the output into a [new issue](https://github.com/Spobi/context-carwash/issues/new) and I'll take a look. Issues are public and errors can include folder names, so give it a quick read first.
 
 ## Where things are kept
 
-Briefs, stats and error logs are kept in `~/.carwash`, readable only by you. Nothing about you is uploaded. Once a day Carwash checks npm for a newer version. Set `CARWASH_NO_UPDATE_CHECK=1` to turn that off.
+Your briefs, stats and error logs live in `~/.carwash`, and only you can read them. Nothing about you gets uploaded. Once a day, Carwash checks npm for a newer version. If you'd rather it didn't, set `CARWASH_NO_UPDATE_CHECK=1`.
 
 ## Uninstall
 
@@ -90,11 +95,11 @@ Briefs, stats and error logs are kept in `~/.carwash`, readable only by you. Not
 npx context-carwash uninstall
 ```
 
-This puts `settings.json` back exactly as it was. If you have edited the file since installing, it removes only Carwash's own status line and hooks and keeps your edits. It then removes the `/wash` command and deletes `~/.carwash`, including any briefs still waiting and your stats.
+This puts `settings.json` back exactly as it was. If you've edited the file since installing, it only removes Carwash's status line and hooks and leaves your changes alone. It also removes the `/wash` command and deletes `~/.carwash`, including any waiting briefs and your stats.
 
 ## Platforms
 
-Developed and tested on macOS. Automated tests also run on Linux and Windows; neither has been tried by hand yet.
+Built and tested on macOS. Automated tests also run on Linux and Windows, but I haven't tried those by hand yet.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-carwash",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "A quiet context meter and deliberate fresh-session handoff for Claude Code.",
   "license": "MIT",
   "repository": {