context-carwash 0.1.8 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/README.md +32 -23
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.0
4
+
5
+ - README demo GIF and a one-line summary at the top.
6
+ - Fixed a test that started failing 48 hours after its fixed test date.
7
+
8
+ ## 0.1.9
9
+
10
+ - Friendlier README wording.
11
+
3
12
  ## 0.1.8
4
13
 
5
14
  - Shorter, clearer README.
package/README.md CHANGED
@@ -1,37 +1,44 @@
1
1
  # Context Carwash
2
2
 
3
+ *Long Claude Code sessions get slow and forgetful. Run it through the wash: keep what matters, drop the rest, start fresh.*
4
+
5
+ ![The meter fills up, /wash writes a short brief, and after /clear a fresh session picks up where the old one stopped](docs/demo.gif)
6
+
3
7
  Context Carwash adds a line to Claude Code in your terminal that:
4
8
 
5
- 1. Shows the current conversation's context size.
6
- 2. Lets you compress your context and start a new session without losing the important details.
9
+ 1. **The Meter:** shows the current conversation's context size.
10
+ 2. **/wash:** lets you compress your context and start a new session without losing important details.
11
+
12
+ 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`.
7
13
 
8
14
  ## Install
9
15
 
10
- Requires Node 18 or later.
16
+ You'll need Node 18 or later.
11
17
 
12
18
  ```sh
13
- npx context-carwash preview # see sample meters, nothing installed
14
- npx context-carwash install # lists what it will change, then asks
19
+ npx context-carwash install
15
20
  ```
16
21
 
17
- 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.
22
+ 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.
18
23
 
19
- 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`.
24
+ When there's a new version, a line under the meter will tell you. To update, run `npx context-carwash@latest install`.
20
25
 
21
- ## The meter
26
+ 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`.
27
+
28
+ ## The Meter
22
29
 
23
30
  ```text
24
31
  session context ~136k [██████████░░░░░] /wash to compress & save context, then /clear keeps compressed context
25
32
  ```
26
33
 
27
- 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.
34
+ 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.
28
35
 
29
36
  ## /wash
30
37
 
31
- 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 ✓`.
32
- 2. Type `/clear`. The new session starts with that brief already loaded.
38
+ 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 ✓`.
39
+ 2. Type `/clear`. Your new session starts with the brief already loaded.
33
40
 
34
- Your old conversation stays in `/resume`.
41
+ Your old conversation isn't gone. You can still find it in `/resume`.
35
42
 
36
43
  | Command | What it does |
37
44
  |---|---|
@@ -44,11 +51,13 @@ Your old conversation stays in `/resume`.
44
51
  | `/wash stats` | How much context your washes have saved |
45
52
  | `/wash help` | Explain the meter and these options |
46
53
 
47
- - Words after the level tell Claude what to focus on: `/wash mid focus on the failing test`.
48
- - A `/clear` with no brief ready is a normal clear.
49
- - Writing a brief is an ordinary Claude reply, so it uses tokens. `help`, `discard` and `load` don't.
50
- - Each level has a size limit based on how big the conversation is. `/wash help` shows them.
51
- - 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.
54
+ A few things worth knowing:
55
+
56
+ - You can tell Claude what to focus on: `/wash mid focus on the failing test`.
57
+ - If you `/clear` without a brief ready, it's just a normal clear.
58
+ - Writing a brief is a normal Claude reply, so it uses some tokens. `help`, `discard` and `load` are free.
59
+ - Bigger conversations get bigger briefs. `/wash help` shows the size limit for each level.
60
+ - 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>`.
52
61
  - Briefs expire after 48 hours.
53
62
 
54
63
  ## Stats
@@ -68,9 +77,9 @@ Carwash stats, since 3 Oct 2026 (12 days)
68
77
  Net saved ~20M tokens
69
78
  ```
70
79
 
71
- 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.
80
+ 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`.
72
81
 
73
- `npx context-carwash stats --share` sends your anonymous totals, but only after showing you exactly what it will send and you say yes.
82
+ If you run `stats --share`, it shows you exactly what it would send before asking.
74
83
 
75
84
  ## Something not working?
76
85
 
@@ -78,11 +87,11 @@ Every request to Claude re-sends the whole conversation. After a wash, each requ
78
87
  npx context-carwash doctor
79
88
  ```
80
89
 
81
- 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.
90
+ 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.
82
91
 
83
92
  ## Where things are kept
84
93
 
85
- 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.
94
+ 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`.
86
95
 
87
96
  ## Uninstall
88
97
 
@@ -90,11 +99,11 @@ Briefs, stats and error logs are kept in `~/.carwash`, readable only by you. Not
90
99
  npx context-carwash uninstall
91
100
  ```
92
101
 
93
- 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.
102
+ 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.
94
103
 
95
104
  ## Platforms
96
105
 
97
- Developed and tested on macOS. Automated tests also run on Linux and Windows; neither has been tried by hand yet.
106
+ Built and tested on macOS. Automated tests also run on Linux and Windows, but I haven't tried those by hand yet.
98
107
 
99
108
  ## License
100
109
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "context-carwash",
3
- "version": "0.1.8",
3
+ "version": "0.2.0",
4
4
  "description": "A quiet context meter and deliberate fresh-session handoff for Claude Code.",
5
5
  "license": "MIT",
6
6
  "repository": {