kompactor 0.8.1__tar.gz → 0.8.2__tar.gz

{kompactor-0.8.1 → kompactor-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kompactor
-Version: 0.8.1
+Version: 0.8.2
 Summary: Cut the tokens Claude Code spends on noise: compacted command output (failing runs included), outline-first reads, a local code graph, and per-turn savings.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/amarkum/kompactor
@@ -98,7 +98,7 @@ Measured in 54 real Claude Code sessions on Flask, Cobra, SWR, ky and zustand at
 - **Outline-first file reads.** Big source files arrive as an outline (symbols, line ranges, who imports the file, which tests cover it). Claude reads just the ranges it needs; repeating the read returns the whole file.
 - **Local code graph.** Find code by topic, see callers, the impact of a change and the tests to run, for Python, Go, TypeScript, JavaScript and React.
 - **Terse replies and lean code.** Short, readable rules for answer-first prose and smallest-diff code, from 0 to 177 tokens depending on the level.
-- **Per-turn savings.** In the reply, the status line, the VS Code status bar and a local dashboard. Numbers are conservative and never count output Claude wouldn't have read.
+- **Per-turn savings, in tokens and dollars.** In the reply, the status line, a VS Code / Cursor sidebar (per session, per project and per turn) and a local dashboard. Numbers are conservative and never count output Claude wouldn't have read.
 - **One dial for quality vs tokens.** Five levels, every option adjustable, per project, with a live preview of exactly what Claude would see.
 - **Nothing is lost.** Every shortened output keeps a raw copy (`kompactor show <id>`), and every hook fails open.
 - **Private and dependency-free.** Python 3.9+ standard library only. Runs locally, sends nothing anywhere, no telemetry.
@@ -123,7 +123,7 @@ kompactor start
 ```
 If your shell says `kompactor: command not found` (pip put the command in a folder that isn't on your PATH), run `python3 -m kompactor start` once. It links `kompactor` into a folder that is already on your PATH, such as `~/.local/bin`, so the command works in every terminal from then on.
 
-**VS Code.** Download `kompactor-0.8.1.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
+**VS Code and Cursor.** `kompactor start` adds the Kompactor extension to VS Code and Cursor automatically when they're installed (skip it with `--no-editor`); reload the window and a **Kompactor** icon appears in the activity bar. To install it by hand, download `kompactor-0.8.2.vsix` from [Releases](https://github.com/amarkum/kompactor/releases) and use Extensions › `⋯` › *Install from VSIX…*.
 
 **From source:**
 ```bash
@@ -136,12 +136,13 @@ git clone https://github.com/amarkum/kompactor.git && ./kompactor/install.sh
 2. **Work as usual.** You don't call Kompactor; it acts on Claude's tool calls by itself. After each reply you'll see a line like `Kompactor: −8.2k tokens this turn`, and the status line shows the running total.
 3. **Check it's on:** run `kompactor` in a terminal (or `/kompactor` in Claude Code):
    ```
-   Kompactor 0.8.1: ON
+   Kompactor 0.8.2: ON
      Connected via the Claude Code plugin. New Claude Code sessions are compacted.
      Level: Balanced (level 3 of 5). Change it: `kompactor config preset 1-5`, the dashboard, or /kompactor balanced
      Saved so far: 41.3k tokens (−38%) over 52 tool calls. Details: `kompactor gain`
    ```
-4. **Three commands to remember:** `kompactor start` turns it on and opens the dashboard, `kompactor stop` pauses it, `kompactor uninstall` removes it.
+4. **In VS Code or Cursor:** click the **Kompactor** icon in the activity bar for tokens and estimated dollars saved this session, in this project, today and over 30 days, plus what every recent turn saved.
+5. **Three commands to remember:** `kompactor start` turns it on and opens the dashboard, `kompactor stop` pauses it, `kompactor uninstall` removes it.
 
 ## How it works
 
@@ -187,9 +188,9 @@ Ask Claude Code the way you normally would. These prompts come from the [evidenc
 
 | Command | What it does |
 |---|---|
-| `kompactor start` | Turn Kompactor on: connect it to Claude Code (CLI + VS Code) and open the dashboard on a free port |
+| `kompactor start` | Turn Kompactor on: connect it to Claude Code (CLI + VS Code), add the extension to VS Code and Cursor, and open the dashboard on a free port |
 | `kompactor stop` | Pause it and close the dashboard; settings are kept |
-| `kompactor uninstall [--purge]` | Remove it from Claude Code (`--purge` also deletes `~/.kompactor`) |
+| `kompactor uninstall` | Remove it from Claude Code and from VS Code / Cursor, and delete its data (`--keep-data` keeps `~/.kompactor`) |
 | `kompactor` / `kompactor status` | On or off, level, savings, how it works |
 | `kompactor presets` · `kompactor config preset 4` | List levels · change level |
 | `kompactor config <setting> <value>` | Change one [setting](#settings) |
@@ -272,7 +273,8 @@ Commit a `.kompactor.json` next to the code to give everyone the same level and
 |---|---|
 | After each reply | `Kompactor: −8.2k tokens this turn (13.1k › 4.9k, −63%) · session −41k · context ≈31% smaller` |
 | CLI status line | `Kompactor −41.3k · ctx −31% · last turn −8.2k · Balanced` |
-| VS Code status bar | Running savings; hover for details |
+| VS Code / Cursor status bar | Tokens and ≈ dollars saved this session; hover for details |
+| VS Code / Cursor sidebar | Kompactor icon in the activity bar: this session, this project, today and 30 days in tokens and dollars, recent turns (saved or "nothing to trim"), biggest wins |
 | Dashboard (`kompactor start`) | Per-turn chart, biggest wins, savings by feature and by project |
 | `kompactor gain` | The same numbers in the terminal |
 | `kompactor estimate` | Replays your **past** sessions and shows what Kompactor would have saved |
@@ -376,7 +378,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 **What it reads.** The tool output Claude Code passes to its hooks, the files Claude reads (to outline them), your project's source (for the code graph), and the context size Claude Code gives the status line. Hooks never read your session transcripts. `kompactor estimate` and the dashboard's **Replay your history** panel read your local Claude Code session logs in `~/.claude/projects` only when you run them; the result isn't stored or sent anywhere.
 
-**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. `kompactor start` edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
+**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. `kompactor start` edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. When VS Code or Cursor is installed, `kompactor start` adds the Kompactor extension to them with their own `code` / `cursor` command (from a copy inside the package; nothing is downloaded), and `kompactor uninstall` removes it and deletes `~/.kompactor`. Nothing is written to your repositories.
 
 **What it never does.** Change your permission rules or sandbox settings, change what a command does, or send your code or output anywhere. Details: [privacy policy](https://github.com/amarkum/kompactor/blob/main/PRIVACY.md).
 
@@ -395,7 +397,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 ```bash
 kompactor stop        # pause: output passes through untouched; settings are kept
 kompactor start       # turn it back on
-kompactor uninstall   # remove hooks, status line, shell prefix and skill (--purge also deletes ~/.kompactor)
+kompactor uninstall   # remove hooks, status line, shell prefix, skill and editor extension, and delete ~/.kompactor
 ```
 Then remove the package the way you installed it: `claude plugin uninstall amarkum@kompactor`, `pipx uninstall kompactor`, or uninstall the extension in VS Code.
 
@@ -419,6 +421,9 @@ The hooks are Claude Code-specific, but `kompactor run -- <command>` and `kompac
 **How much latency does it add?**
 About 50–100 ms per hook, because the filters run in Python.
 
+**How are the dollar figures worked out?**
+They're estimates at an input-token price you set (`kompactor.pricePerMillionTokens` in VS Code, default $3 per million). Each token kept out of the context is counted once as a prompt-cache write (1.25× the input price) and once more at the cache-read price (0.1×) for every later turn in that session that would have re-read it.
+
 **Is it free?**
 Yes. MIT-licensed, no account, no paid tier.
 

{kompactor-0.8.1 → kompactor-0.8.2}/README.md

@@ -65,7 +65,7 @@ Measured in 54 real Claude Code sessions on Flask, Cobra, SWR, ky and zustand at
 - **Outline-first file reads.** Big source files arrive as an outline (symbols, line ranges, who imports the file, which tests cover it). Claude reads just the ranges it needs; repeating the read returns the whole file.
 - **Local code graph.** Find code by topic, see callers, the impact of a change and the tests to run, for Python, Go, TypeScript, JavaScript and React.
 - **Terse replies and lean code.** Short, readable rules for answer-first prose and smallest-diff code, from 0 to 177 tokens depending on the level.
-- **Per-turn savings.** In the reply, the status line, the VS Code status bar and a local dashboard. Numbers are conservative and never count output Claude wouldn't have read.
+- **Per-turn savings, in tokens and dollars.** In the reply, the status line, a VS Code / Cursor sidebar (per session, per project and per turn) and a local dashboard. Numbers are conservative and never count output Claude wouldn't have read.
 - **One dial for quality vs tokens.** Five levels, every option adjustable, per project, with a live preview of exactly what Claude would see.
 - **Nothing is lost.** Every shortened output keeps a raw copy (`kompactor show <id>`), and every hook fails open.
 - **Private and dependency-free.** Python 3.9+ standard library only. Runs locally, sends nothing anywhere, no telemetry.
@@ -90,7 +90,7 @@ kompactor start
 ```
 If your shell says `kompactor: command not found` (pip put the command in a folder that isn't on your PATH), run `python3 -m kompactor start` once. It links `kompactor` into a folder that is already on your PATH, such as `~/.local/bin`, so the command works in every terminal from then on.
 
-**VS Code.** Download `kompactor-0.8.1.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
+**VS Code and Cursor.** `kompactor start` adds the Kompactor extension to VS Code and Cursor automatically when they're installed (skip it with `--no-editor`); reload the window and a **Kompactor** icon appears in the activity bar. To install it by hand, download `kompactor-0.8.2.vsix` from [Releases](https://github.com/amarkum/kompactor/releases) and use Extensions › `⋯` › *Install from VSIX…*.
 
 **From source:**
 ```bash
@@ -103,12 +103,13 @@ git clone https://github.com/amarkum/kompactor.git && ./kompactor/install.sh
 2. **Work as usual.** You don't call Kompactor; it acts on Claude's tool calls by itself. After each reply you'll see a line like `Kompactor: −8.2k tokens this turn`, and the status line shows the running total.
 3. **Check it's on:** run `kompactor` in a terminal (or `/kompactor` in Claude Code):
    ```
-   Kompactor 0.8.1: ON
+   Kompactor 0.8.2: ON
      Connected via the Claude Code plugin. New Claude Code sessions are compacted.
      Level: Balanced (level 3 of 5). Change it: `kompactor config preset 1-5`, the dashboard, or /kompactor balanced
      Saved so far: 41.3k tokens (−38%) over 52 tool calls. Details: `kompactor gain`
    ```
-4. **Three commands to remember:** `kompactor start` turns it on and opens the dashboard, `kompactor stop` pauses it, `kompactor uninstall` removes it.
+4. **In VS Code or Cursor:** click the **Kompactor** icon in the activity bar for tokens and estimated dollars saved this session, in this project, today and over 30 days, plus what every recent turn saved.
+5. **Three commands to remember:** `kompactor start` turns it on and opens the dashboard, `kompactor stop` pauses it, `kompactor uninstall` removes it.
 
 ## How it works
 
@@ -154,9 +155,9 @@ Ask Claude Code the way you normally would. These prompts come from the [evidenc
 
 | Command | What it does |
 |---|---|
-| `kompactor start` | Turn Kompactor on: connect it to Claude Code (CLI + VS Code) and open the dashboard on a free port |
+| `kompactor start` | Turn Kompactor on: connect it to Claude Code (CLI + VS Code), add the extension to VS Code and Cursor, and open the dashboard on a free port |
 | `kompactor stop` | Pause it and close the dashboard; settings are kept |
-| `kompactor uninstall [--purge]` | Remove it from Claude Code (`--purge` also deletes `~/.kompactor`) |
+| `kompactor uninstall` | Remove it from Claude Code and from VS Code / Cursor, and delete its data (`--keep-data` keeps `~/.kompactor`) |
 | `kompactor` / `kompactor status` | On or off, level, savings, how it works |
 | `kompactor presets` · `kompactor config preset 4` | List levels · change level |
 | `kompactor config <setting> <value>` | Change one [setting](#settings) |
@@ -239,7 +240,8 @@ Commit a `.kompactor.json` next to the code to give everyone the same level and
 |---|---|
 | After each reply | `Kompactor: −8.2k tokens this turn (13.1k › 4.9k, −63%) · session −41k · context ≈31% smaller` |
 | CLI status line | `Kompactor −41.3k · ctx −31% · last turn −8.2k · Balanced` |
-| VS Code status bar | Running savings; hover for details |
+| VS Code / Cursor status bar | Tokens and ≈ dollars saved this session; hover for details |
+| VS Code / Cursor sidebar | Kompactor icon in the activity bar: this session, this project, today and 30 days in tokens and dollars, recent turns (saved or "nothing to trim"), biggest wins |
 | Dashboard (`kompactor start`) | Per-turn chart, biggest wins, savings by feature and by project |
 | `kompactor gain` | The same numbers in the terminal |
 | `kompactor estimate` | Replays your **past** sessions and shows what Kompactor would have saved |
@@ -343,7 +345,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 **What it reads.** The tool output Claude Code passes to its hooks, the files Claude reads (to outline them), your project's source (for the code graph), and the context size Claude Code gives the status line. Hooks never read your session transcripts. `kompactor estimate` and the dashboard's **Replay your history** panel read your local Claude Code session logs in `~/.claude/projects` only when you run them; the result isn't stored or sent anywhere.
 
-**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. `kompactor start` edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
+**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. `kompactor start` edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. When VS Code or Cursor is installed, `kompactor start` adds the Kompactor extension to them with their own `code` / `cursor` command (from a copy inside the package; nothing is downloaded), and `kompactor uninstall` removes it and deletes `~/.kompactor`. Nothing is written to your repositories.
 
 **What it never does.** Change your permission rules or sandbox settings, change what a command does, or send your code or output anywhere. Details: [privacy policy](https://github.com/amarkum/kompactor/blob/main/PRIVACY.md).
 
@@ -362,7 +364,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 ```bash
 kompactor stop        # pause: output passes through untouched; settings are kept
 kompactor start       # turn it back on
-kompactor uninstall   # remove hooks, status line, shell prefix and skill (--purge also deletes ~/.kompactor)
+kompactor uninstall   # remove hooks, status line, shell prefix, skill and editor extension, and delete ~/.kompactor
 ```
 Then remove the package the way you installed it: `claude plugin uninstall amarkum@kompactor`, `pipx uninstall kompactor`, or uninstall the extension in VS Code.
 
@@ -386,6 +388,9 @@ The hooks are Claude Code-specific, but `kompactor run -- <command>` and `kompac
 **How much latency does it add?**
 About 50–100 ms per hook, because the filters run in Python.
 
+**How are the dollar figures worked out?**
+They're estimates at an input-token price you set (`kompactor.pricePerMillionTokens` in VS Code, default $3 per million). Each token kept out of the context is counted once as a prompt-cache write (1.25× the input price) and once more at the cache-read price (0.1×) for every later turn in that session that would have re-read it.
+
 **Is it free?**
 Yes. MIT-licensed, no account, no paid tier.
 

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor/__init__.py

@@ -1,3 +1,3 @@
 """Kompactor: cut the tokens Claude Code spends on noise."""
 
-__version__ = "0.8.1"
+__version__ = "0.8.2"

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor/cli.py

@@ -151,6 +151,12 @@ def cmd_hook(a):
 
 
 def cmd_gain(a):
+    if a.json:
+        project = config.project_root(a.project) if a.project else ""
+        print(json.dumps({**store.savings(a.price, a.session or "", project), "project_path": project,
+                          "paused": store.paused(),
+                          "version": __version__}))
+        return 0
     with store.connect() as db:
         rows = db.execute("SELECT feature, COUNT(*), SUM(raw_tokens), SUM(kept_tokens) FROM events GROUP BY feature "
                           "ORDER BY SUM(raw_tokens) - SUM(kept_tokens) DESC").fetchall()
@@ -218,7 +224,7 @@ Use it from Claude Code
 
 Turn it off
   kompactor stop        pause it (settings kept); `kompactor start` resumes
-  kompactor uninstall   remove it from Claude Code (--purge also deletes ~/.kompactor)
+  kompactor uninstall   remove it from Claude Code, VS Code and Cursor, and delete its data
 
 Evidence
   Measured A/B runs of real Claude Code tasks: {EVIDENCE_URL}
@@ -337,6 +343,10 @@ def cmd_start(a):
     print(f"  Connected via {'the Claude Code plugin' if st['plugin_enabled'] else where}")
     _prefix_note(st)
     _path_note(installer.link_on_path())
+    if not a.no_editor:
+        added = installer.install_editor_extension()
+        if added:
+            print(f"  Added the Kompactor extension to {' and '.join(added)}: reload the window to see its sidebar.")
     d = _dashboard()
     if not d:
         from . import server
@@ -375,17 +385,20 @@ def cmd_stop(a):
 
 
 def cmd_uninstall(a):
-    """Stop, remove hooks / status line / shell prefix / skill, and optionally delete data."""
+    """Stop, remove hooks / status line / shell prefix / skill / editor extension, and delete Kompactor's data."""
     _kill_dashboard()
     target = installer.install(uninstall=True)
     print(f"✓ Removed Kompactor from {target}")
-    if a.purge:
+    removed = installer.uninstall_editor_extension()
+    if removed:
+        print(f"  Removed the Kompactor extension from {' and '.join(removed)}.")
+    if a.keep_data:
+        (store.home() / "paused").unlink(missing_ok=True)
+        print("  Kept savings history and settings in ~/.kompactor.")
+    else:
         import shutil
         shutil.rmtree(store.home(), ignore_errors=True)
-        print("  Deleted savings history and config (~/.kompactor).")
-    else:
-        (store.home() / "paused").unlink(missing_ok=True)
-        print("  Kept savings history and config in ~/.kompactor (add --purge to delete).")
+        print("  Deleted Kompactor's data: savings history, settings, code graphs and saved outputs (~/.kompactor).")
     if installer.status()["plugin_enabled"]:
         print("  The Claude Code plugin is still enabled; run: claude plugin uninstall amarkum@kompactor")
     print("  Installed it as a Python package? Remove that too, with the tool you installed it with (pip, pipx or uv).")
@@ -490,13 +503,15 @@ def main(argv=None):
     p = sp.add_parser("start", help="turn Kompactor on: connect it to Claude Code and open the dashboard")
     p.add_argument("--port", type=int, default=0, help="preferred port (default: any free port)")
     p.add_argument("--no-browser", action="store_true")
+    p.add_argument("--no-editor", action="store_true", help="don't add the extension to VS Code or Cursor")
     p.set_defaults(fn=cmd_start)
 
     p = sp.add_parser("stop", help="pause Kompactor and close the dashboard (settings are kept)")
     p.set_defaults(fn=cmd_stop)
 
     p = sp.add_parser("uninstall", help="stop and remove Kompactor from Claude Code settings")
-    p.add_argument("--purge", action="store_true", help="also delete ~/.kompactor (history and config)")
+    p.add_argument("--keep-data", action="store_true", help="keep ~/.kompactor (history and settings)")
+    p.add_argument("--purge", action="store_true", help=argparse.SUPPRESS)  # the default now; kept for old docs
     p.set_defaults(fn=cmd_uninstall)
 
     p = sp.add_parser("estimate", help="replay past Claude Code sessions and show %% Kompactor would save")
@@ -508,6 +523,10 @@ def main(argv=None):
     p.set_defaults(fn=cmd_estimate)
 
     p = sp.add_parser("gain", help="live savings recorded by the hooks")
+    p.add_argument("--json", action="store_true", help="machine-readable totals with a dollar estimate")
+    p.add_argument("--price", type=float, default=3.0, help="input-token price in USD per million (default 3)")
+    p.add_argument("--session", help="also report this Claude Code session")
+    p.add_argument("--project", help="also report this project folder, with its recent turns")
     p.set_defaults(fn=cmd_gain)
 
     p = sp.add_parser("ui", help="open the settings & savings dashboard (foreground; see `start`)")

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor/installer.py

@@ -65,6 +65,68 @@ def write_shim(only_if_changed: bool = False) -> Path:
     return d / "kompactor"
 
 
+# The VS Code extension ships inside the Python package (kompactor/vsix/, built by scripts/build-vsix.sh),
+# so `kompactor start` can add it to VS Code and Cursor without downloading anything.
+EXTENSION_ID = "kompactor.kompactor"
+EDITORS = (("VS Code", "code", "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code", ".vscode"),
+           ("Cursor", "cursor", "/Applications/Cursor.app/Contents/Resources/app/bin/cursor", ".cursor"))
+
+
+def bundled_vsix():
+    from . import __version__
+    p = Path(__file__).with_name("vsix") / f"kompactor-{__version__}.vsix"
+    return p if p.exists() else None
+
+
+def editors() -> list:
+    """(name, command-line tool, extensions folder) for each VS Code-family editor on this machine."""
+    found = []
+    for name, cmd, mac_path, home_dir in EDITORS:
+        cli = shutil.which(cmd) or (mac_path if os.path.exists(mac_path) else "")
+        if cli:
+            found.append((name, cli, Path.home() / home_dir / "extensions"))
+    return found
+
+
+def _has_extension(ext_dir: Path, version: str = "") -> bool:
+    return any(ext_dir.glob(f"{EXTENSION_ID}-{version or '*'}"))
+
+
+def install_editor_extension() -> list:
+    """Add the bundled extension to each editor that doesn't have this version yet; returns the editor names."""
+    import subprocess
+    from . import __version__
+    vsix = bundled_vsix()
+    done = []
+    for name, cli, ext_dir in editors() if vsix else []:
+        if _has_extension(ext_dir, __version__):
+            continue
+        try:
+            r = subprocess.run([cli, "--install-extension", str(vsix), "--force"], capture_output=True, text=True,
+                               timeout=180)
+        except (OSError, subprocess.SubprocessError):
+            continue
+        if r.returncode == 0:
+            done.append(name)
+    return done
+
+
+def uninstall_editor_extension() -> list:
+    """Remove the extension from every editor that has it; returns the editor names."""
+    import subprocess
+    done = []
+    for name, cli, ext_dir in editors():
+        if not _has_extension(ext_dir):
+            continue
+        try:
+            r = subprocess.run([cli, "--uninstall-extension", EXTENSION_ID], capture_output=True, text=True, timeout=180)
+        except (OSError, subprocess.SubprocessError):
+            continue
+        if r.returncode == 0:
+            done.append(name)
+    return done
+
+
 # Where a `kompactor` command can be linked when pip put it in a folder that isn't on PATH.
 PATH_DIRS = ("~/.local/bin", "~/bin", "/opt/homebrew/bin", "/usr/local/bin")
 

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor/static/usage.html

@@ -139,7 +139,7 @@ svg.chev { width: 11px; height: 11px; stroke: var(--ink-3); fill: none; stroke-w
           <pre><code>pipx install kompactor
 kompactor start</code></pre></div>
         <div class="card"><b>VS Code</b><span class="muted">Download the extension file from the repo's Releases page, then click <b>Enable</b> when Kompactor asks.</span>
-          <pre><code>code --install-extension kompactor-0.8.1.vsix</code></pre></div>
+          <pre><code>code --install-extension kompactor-0.8.2.vsix</code></pre></div>
       </div>
       <p class="muted">Windows: run <code>.\kompactor\install.ps1</code> from a clone, or use the VS Code extension. The CLI and the VS Code extension read the same <code>~/.claude/settings.json</code>, so one install covers both. A backup of that file is kept as <code>settings.json.kompactor-backup</code>.</p>
       <p class="muted"><code>kompactor start</code> adds hooks, a status line (if you don't have one) and, on macOS and Linux, Claude Code's <code>CLAUDE_CODE_SHELL_PREFIX</code> setting pointing at <code>~/.kompactor/bin/kompactor-shell</code>, which is what lets Kompactor compact failing commands. It never replaces a status line or shell prefix you already have. Restart open Claude Code sessions after setup.</p>

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor/store.py

@@ -143,6 +143,49 @@ def session_totals(session: str) -> dict:
             "context": last[2] if last else 0, "last_turn_saved": (last[0] - last[1]) if last else 0}
 
 
+def savings(price_per_mtok: float = 3.0, session: str = "", project: str = "") -> dict:
+    """Tokens kept out of Claude's context, with a dollar estimate at `price_per_mtok` (the input-token
+    price). A kept-out token would have been written to the prompt cache once (1.25x) and re-read on every
+    later turn of its session (0.1x each), the same weights `kompactor estimate` uses."""
+    now = time.time()
+    day = now - 86400
+    with connect() as db:
+        def total(where="1", args=()):
+            r = db.execute(f"SELECT COUNT(*), COALESCE(SUM(raw_tokens),0), COALESCE(SUM(kept_tokens),0) FROM events "
+                           f"WHERE {where}", args).fetchone()
+            return {"events": r[0], "raw": r[1], "kept": r[2], "saved": r[1] - r[2]}
+        periods = {"all": total(), "today": total("ts > ?", (day,))}
+        if session:
+            periods["session"] = total("session = ?", (session,))
+        if project:
+            periods["project"] = total("project = ?", (project,))
+        recent = db.execute("SELECT session, idx, ts, raw_tokens, kept_tokens, features FROM turns "
+                            "WHERE project = ? OR (? = '' AND session = ?) ORDER BY ts DESC LIMIT 12",
+                            (project, project, session)).fetchall()
+        turns = db.execute("SELECT session, ts, raw_tokens - kept_tokens, project FROM turns "
+                           "ORDER BY session, idx").fetchall()
+        top = db.execute("SELECT detail, COUNT(*), SUM(raw_tokens), SUM(kept_tokens) FROM events WHERE feature='bash' "
+                         "GROUP BY detail ORDER BY SUM(raw_tokens) - SUM(kept_tokens) DESC LIMIT 5").fetchall()
+        sessions = db.execute("SELECT COUNT(DISTINCT session) FROM events").fetchone()[0]
+    rereads = {"all": 0.0, "today": 0.0, "session": 0.0, "project": 0.0}
+    by_session = {}
+    for s, ts, saved, proj in turns:
+        by_session.setdefault(s, []).append((ts, saved, proj))
+    for s, rows in by_session.items():
+        for i, (ts, saved, proj) in enumerate(rows):
+            later = (len(rows) - i - 1) * saved * 0.1
+            rereads["all"] += later
+            rereads["today"] += later if ts > day else 0
+            rereads["session"] += later if s == session else 0
+            rereads["project"] += later if project and proj == project else 0
+    for k, p in periods.items():
+        p["usd"] = round((p["saved"] * 1.25 + rereads[k]) * price_per_mtok / 1e6, 4)
+    return {"price_per_mtok": price_per_mtok, "sessions": sessions, **periods,
+            "top": [{"cmd": t[0], "runs": t[1], "raw": t[2], "kept": t[3]} for t in top],
+            "turns": [{"session": t[0], "idx": t[1], "ts": t[2], "raw": t[3], "kept": t[4], "saved": t[3] - t[4],
+                       "features": json.loads(t[5] or "{}")} for t in recent]}
+
+
 def prune(retention_days: float) -> None:
     """Drop data older than the retention window (called at session start)."""
     cutoff = time.time() - retention_days * 86400

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kompactor
-Version: 0.8.1
+Version: 0.8.2
 Summary: Cut the tokens Claude Code spends on noise: compacted command output (failing runs included), outline-first reads, a local code graph, and per-turn savings.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/amarkum/kompactor
@@ -98,7 +98,7 @@ Measured in 54 real Claude Code sessions on Flask, Cobra, SWR, ky and zustand at
 - **Outline-first file reads.** Big source files arrive as an outline (symbols, line ranges, who imports the file, which tests cover it). Claude reads just the ranges it needs; repeating the read returns the whole file.
 - **Local code graph.** Find code by topic, see callers, the impact of a change and the tests to run, for Python, Go, TypeScript, JavaScript and React.
 - **Terse replies and lean code.** Short, readable rules for answer-first prose and smallest-diff code, from 0 to 177 tokens depending on the level.
-- **Per-turn savings.** In the reply, the status line, the VS Code status bar and a local dashboard. Numbers are conservative and never count output Claude wouldn't have read.
+- **Per-turn savings, in tokens and dollars.** In the reply, the status line, a VS Code / Cursor sidebar (per session, per project and per turn) and a local dashboard. Numbers are conservative and never count output Claude wouldn't have read.
 - **One dial for quality vs tokens.** Five levels, every option adjustable, per project, with a live preview of exactly what Claude would see.
 - **Nothing is lost.** Every shortened output keeps a raw copy (`kompactor show <id>`), and every hook fails open.
 - **Private and dependency-free.** Python 3.9+ standard library only. Runs locally, sends nothing anywhere, no telemetry.
@@ -123,7 +123,7 @@ kompactor start
 ```
 If your shell says `kompactor: command not found` (pip put the command in a folder that isn't on your PATH), run `python3 -m kompactor start` once. It links `kompactor` into a folder that is already on your PATH, such as `~/.local/bin`, so the command works in every terminal from then on.
 
-**VS Code.** Download `kompactor-0.8.1.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
+**VS Code and Cursor.** `kompactor start` adds the Kompactor extension to VS Code and Cursor automatically when they're installed (skip it with `--no-editor`); reload the window and a **Kompactor** icon appears in the activity bar. To install it by hand, download `kompactor-0.8.2.vsix` from [Releases](https://github.com/amarkum/kompactor/releases) and use Extensions › `⋯` › *Install from VSIX…*.
 
 **From source:**
 ```bash
@@ -136,12 +136,13 @@ git clone https://github.com/amarkum/kompactor.git && ./kompactor/install.sh
 2. **Work as usual.** You don't call Kompactor; it acts on Claude's tool calls by itself. After each reply you'll see a line like `Kompactor: −8.2k tokens this turn`, and the status line shows the running total.
 3. **Check it's on:** run `kompactor` in a terminal (or `/kompactor` in Claude Code):
    ```
-   Kompactor 0.8.1: ON
+   Kompactor 0.8.2: ON
      Connected via the Claude Code plugin. New Claude Code sessions are compacted.
      Level: Balanced (level 3 of 5). Change it: `kompactor config preset 1-5`, the dashboard, or /kompactor balanced
      Saved so far: 41.3k tokens (−38%) over 52 tool calls. Details: `kompactor gain`
    ```
-4. **Three commands to remember:** `kompactor start` turns it on and opens the dashboard, `kompactor stop` pauses it, `kompactor uninstall` removes it.
+4. **In VS Code or Cursor:** click the **Kompactor** icon in the activity bar for tokens and estimated dollars saved this session, in this project, today and over 30 days, plus what every recent turn saved.
+5. **Three commands to remember:** `kompactor start` turns it on and opens the dashboard, `kompactor stop` pauses it, `kompactor uninstall` removes it.
 
 ## How it works
 
@@ -187,9 +188,9 @@ Ask Claude Code the way you normally would. These prompts come from the [evidenc
 
 | Command | What it does |
 |---|---|
-| `kompactor start` | Turn Kompactor on: connect it to Claude Code (CLI + VS Code) and open the dashboard on a free port |
+| `kompactor start` | Turn Kompactor on: connect it to Claude Code (CLI + VS Code), add the extension to VS Code and Cursor, and open the dashboard on a free port |
 | `kompactor stop` | Pause it and close the dashboard; settings are kept |
-| `kompactor uninstall [--purge]` | Remove it from Claude Code (`--purge` also deletes `~/.kompactor`) |
+| `kompactor uninstall` | Remove it from Claude Code and from VS Code / Cursor, and delete its data (`--keep-data` keeps `~/.kompactor`) |
 | `kompactor` / `kompactor status` | On or off, level, savings, how it works |
 | `kompactor presets` · `kompactor config preset 4` | List levels · change level |
 | `kompactor config <setting> <value>` | Change one [setting](#settings) |
@@ -272,7 +273,8 @@ Commit a `.kompactor.json` next to the code to give everyone the same level and
 |---|---|
 | After each reply | `Kompactor: −8.2k tokens this turn (13.1k › 4.9k, −63%) · session −41k · context ≈31% smaller` |
 | CLI status line | `Kompactor −41.3k · ctx −31% · last turn −8.2k · Balanced` |
-| VS Code status bar | Running savings; hover for details |
+| VS Code / Cursor status bar | Tokens and ≈ dollars saved this session; hover for details |
+| VS Code / Cursor sidebar | Kompactor icon in the activity bar: this session, this project, today and 30 days in tokens and dollars, recent turns (saved or "nothing to trim"), biggest wins |
 | Dashboard (`kompactor start`) | Per-turn chart, biggest wins, savings by feature and by project |
 | `kompactor gain` | The same numbers in the terminal |
 | `kompactor estimate` | Replays your **past** sessions and shows what Kompactor would have saved |
@@ -376,7 +378,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 **What it reads.** The tool output Claude Code passes to its hooks, the files Claude reads (to outline them), your project's source (for the code graph), and the context size Claude Code gives the status line. Hooks never read your session transcripts. `kompactor estimate` and the dashboard's **Replay your history** panel read your local Claude Code session logs in `~/.claude/projects` only when you run them; the result isn't stored or sent anywhere.
 
-**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. `kompactor start` edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
+**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. `kompactor start` edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. When VS Code or Cursor is installed, `kompactor start` adds the Kompactor extension to them with their own `code` / `cursor` command (from a copy inside the package; nothing is downloaded), and `kompactor uninstall` removes it and deletes `~/.kompactor`. Nothing is written to your repositories.
 
 **What it never does.** Change your permission rules or sandbox settings, change what a command does, or send your code or output anywhere. Details: [privacy policy](https://github.com/amarkum/kompactor/blob/main/PRIVACY.md).
 
@@ -395,7 +397,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 ```bash
 kompactor stop        # pause: output passes through untouched; settings are kept
 kompactor start       # turn it back on
-kompactor uninstall   # remove hooks, status line, shell prefix and skill (--purge also deletes ~/.kompactor)
+kompactor uninstall   # remove hooks, status line, shell prefix, skill and editor extension, and delete ~/.kompactor
 ```
 Then remove the package the way you installed it: `claude plugin uninstall amarkum@kompactor`, `pipx uninstall kompactor`, or uninstall the extension in VS Code.
 
@@ -419,6 +421,9 @@ The hooks are Claude Code-specific, but `kompactor run -- <command>` and `kompac
 **How much latency does it add?**
 About 50–100 ms per hook, because the filters run in Python.
 
+**How are the dollar figures worked out?**
+They're estimates at an input-token price you set (`kompactor.pricePerMillionTokens` in VS Code, default $3 per million). Each token kept out of the context is counted once as a prompt-cache write (1.25× the input price) and once more at the cache-read price (0.1×) for every later turn in that session that would have re-read it.
+
 **Is it free?**
 Yes. MIT-licensed, no account, no paid tier.
 

{kompactor-0.8.1 → kompactor-0.8.2}/kompactor.egg-info/SOURCES.txt

@@ -35,6 +35,7 @@ kompactor/static/fonts/plex-mono-500.woff2
 kompactor/static/fonts/plex-sans-400.woff2
 kompactor/static/fonts/plex-sans-500.woff2
 kompactor/static/fonts/plex-sans-600.woff2
+kompactor/vsix/kompactor-0.8.2.vsix
 tests/test_graph.py
 tests/test_kompactor.py
 tests/test_shell.py

{kompactor-0.8.1 → kompactor-0.8.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kompactor"
-version = "0.8.1"
+version = "0.8.2"
 description = "Cut the tokens Claude Code spends on noise: compacted command output (failing runs included), outline-first reads, a local code graph, and per-turn savings."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -44,9 +44,10 @@ exact = ["tiktoken>=0.7"]
 kompactor = "kompactor.cli:main"
 
 [tool.setuptools]
-packages = ["kompactor", "kompactor.static", "kompactor.static.fonts"]
+packages = ["kompactor", "kompactor.static", "kompactor.static.fonts", "kompactor.vsix"]
 
 [tool.setuptools.package-data]
 kompactor = ["ui.html"]
 "kompactor.static" = ["*.html", "*.svg"]
 "kompactor.static.fonts" = ["*.woff2", "*.txt"]
+"kompactor.vsix" = ["*.vsix"]

{kompactor-0.8.1 → kompactor-0.8.2}/tests/test_graph.py

@@ -13,6 +13,7 @@ os.environ.setdefault("KOMPACTOR_HOME", tempfile.mkdtemp())
 
 from kompactor import config, graph, hooks, installer  # noqa: E402
 installer.PATH_DIRS = ()  # never link `kompactor` into real PATH folders from tests
+installer.EDITORS = ()  # never install or remove the real VS Code / Cursor extension from tests
 
 
 def make_repo(files: dict) -> str:

{kompactor-0.8.1 → kompactor-0.8.2}/tests/test_kompactor.py

@@ -13,6 +13,7 @@ os.environ["KOMPACTOR_HOME"] = os.path.join(TMP, "home")
 
 from kompactor import config, estimate, filters, hooks, installer, langs, outline, server, store, tokens  # noqa: E402
 installer.PATH_DIRS = ()  # never link `kompactor` into real PATH folders from tests
+installer.EDITORS = ()  # never install or remove the real VS Code / Cursor extension from tests
 
 
 def run_hook(name, event):
@@ -584,6 +585,29 @@ class SourceTests(unittest.TestCase):
             installer.unlink_from_path(dirs=(str(on_path),))
             self.assertTrue((on_path / "kompactor").exists())
 
+    @unittest.skipIf(os.name == "nt", "uses a POSIX shell script as the fake editor")
+    def test_editor_extension_added_once_and_removed(self):
+        from unittest import mock
+        from kompactor import __version__
+        tmp = Path(tempfile.mkdtemp())
+        ext, log, cli, vsix = tmp / "extensions", tmp / "log", tmp / "code", tmp / "k.vsix"
+        ext.mkdir(); vsix.write_text("x")
+        cli.write_text(f"""#!/bin/sh
+echo "$@" >> '{log}'
+[ "$1" = --install-extension ] && mkdir -p '{ext}/kompactor.kompactor-{__version__}'
+[ "$1" = --uninstall-extension ] && rm -rf '{ext}'/kompactor.kompactor-*
+exit 0
+""")
+        cli.chmod(0o755)
+        fake = (("VS Code", "no-such-editor-command", str(cli), str(tmp)),)
+        with mock.patch.object(installer, "EDITORS", fake), mock.patch.object(installer, "bundled_vsix", return_value=vsix):
+            self.assertEqual(installer.install_editor_extension(), ["VS Code"])
+            self.assertEqual(installer.install_editor_extension(), [])          # this version is already there
+            self.assertEqual(installer.uninstall_editor_extension(), ["VS Code"])
+            self.assertEqual(installer.uninstall_editor_extension(), [])        # nothing left to remove
+        self.assertEqual(log.read_text().split("\n")[:2],
+                         [f"--install-extension {vsix} --force", "--uninstall-extension kompactor.kompactor"])
+
     def test_source_defaults_to_the_public_repo(self):
         self.assertEqual(installer.source("")["marketplace"], "amarkum/kompactor")
         self.assertEqual(installer.source("acme/kompactor")["clone"], "https://github.com/acme/kompactor.git")  # a fork

{kompactor-0.8.1 → kompactor-0.8.2}/tests/test_shell.py

@@ -21,6 +21,7 @@ sys.path.insert(0, str(ROOT))
 
 from kompactor import filters, hooks, installer, shellwrap, tokens  # noqa: E402
 installer.PATH_DIRS = ()  # never link `kompactor` into real PATH folders from tests
+installer.EDITORS = ()  # never install or remove the real VS Code / Cursor extension from tests
 
 PASSING = "".join(f"tests/test_mod.py::test_case_{i} PASSED{' ' * 30}[{i // 5:3d}%]\n" for i in range(500))
 FAILURE = ("=================================== FAILURES ===================================\n"