@tokenade/cli 0.8.10 → 0.8.11

package/README.md

@@ -141,24 +141,27 @@ When reporting, please include your OS, `tokenade --version`, your coding agent,
 | Command | What it does |
 |---|---|
 | `wrap <cmd>` | Run a command through the auto-detected compactor (default for noisy commands). |
-| `proxy <cmd...>` | Run a command and emit compressed output (logs savings). |
 | `raw <cmd...>` | Run a command **without** compaction (aliases: `bypass`, `noproxy`). |
 | `filter <cmd...>` | Filter stdin as if it were produced by `<cmd>`. |
 | `execute --lang L --script CODE` | Sandboxed "think-in-code" runner (bash/python/node/jq/awk/ruby/perl) — returns only stdout, redacted + compacted, keeps raw data out of context. |
 | `shell-init` | Print the shell proxy fragment for your shell (`--shell …`, `--all`). |
 | `shellwrap` | TTY-aware alias target for csh/tcsh + cmd.exe. |
 
-### Format compactors
+### Read & compact content
 
-`auto <file|->` auto-detects the format and dispatches to the right compactor — **the one to call** if unsure. Or target a format directly (all read `<file>` or `-` for stdin):
+`read <file|->` is the content entry point: it auto-detects a blob's format and
+dispatches to the right compactor. Point it at a file (or `-` for stdin) carrying
+JSON, YAML, CSV/TSV, NDJSON, logs, unified diffs, stack traces, env dumps,
+markdown, lockfiles, SQL, OpenAPI/GraphQL, build & CI output, and many more —
+the format is detected automatically. Live command output is compacted the same
+way through `wrap`.
 
-| Domain | Commands |
+| Command | What it does |
 |---|---|
-| **Data & config** | `json` · `csv` · `tsv` · `yaml` · `ndjson` · `lock` · `sql` · `env` · `md` · `openapi` · `graphql` · `sourcemap` |
-| **Logs & traces** | `logs` · `access` · `journal` · `container-logs` · `ghactions` · `stack` · `strace` · `tcpdump` · `metrics` |
-| **Build / VCS / infra** | `diff` · `gitlog` · `archive` · `cargo-bench` · `jvmbuild` (aliases `mvn`/`gradle`/`sbt`) · `pkginstall` · `terraform` · `ansible` · `k8s-manifest` · `describe` · `systemd` |
-| **System & network** | `table` · `disk` · `netstat` · `dns` · `vmstat` · `filelist` · `grep` |
-| **Web & docs** | `web` · `serp` (aliases `google`/`bing`/`ddg`) · `snapshot` · `stealth` · `curl` · `docs` · `pdf` · `notebook` |
+| `read <file\|->` | Auto-detect a blob's format and compact it (**the content entry point**). |
+| `web <file\|->` | Compact an HTML page → markdown (real web content). |
+| `serp <file\|->` | Compact raw SERP HTML (aliases: `google`/`bing`/`ddg`). |
+| `snapshot <file\|->` | Compact a Playwright accessibility-tree snapshot. |
 
 **Your own compactors.** `add-compactor --file <rules.toml>` teaches Tokenade to fold output from a command it doesn't cover yet (alias `add-filter`); `add-compactor --list` shows the ones you've added, and `add-compactor --help` prints the file format. Filters shipped INSIDE a repo (`.tokenade/filters/`) apply only after you approve them once with `trust-filters` — a cloned project can't silently rewrite your outputs.
 
@@ -210,7 +213,7 @@ When reporting, please include your OS, `tokenade --version`, your coding agent,
 
 ## Examples & recipes
 
-Real commands, real (trimmed) output — so both humans **and coding agents** know exactly what each command does and when to reach for it. Every compactor reads a file **or `-` for stdin**, so you can pipe: `some-noisy-cmd | tokenade auto -`.
+Real commands, real (trimmed) output — so both humans **and coding agents** know exactly what each command does and when to reach for it. `read` (and every format-aware entry point) reads a file **or `-` for stdin**, so you can pipe: `some-noisy-cmd | tokenade read -`.
 
 ### Setup & account
 
@@ -345,20 +348,20 @@ $ tokenade execute --lang python --script 'print(sum(range(101)))'
 5050
 ```
 
-**`proxy <cmd…>`** — like `wrap`, logs savings to your ledger. **`raw <cmd…>`** — run *without* compaction (escape hatch). **`filter <cmd…>`** — treat stdin as if produced by `<cmd>`. **`shell-init`** — print the shell fragment that auto-wraps noisy commands:
+**`raw <cmd…>`** — run *without* compaction (escape hatch). **`filter <cmd…>`** — treat stdin as if produced by `<cmd>`. **`shell-init`** — print the shell fragment that auto-wraps noisy commands:
 ```text
 $ eval "$(tokenade shell-init)"   # add to ~/.zshrc — git/cargo/kubectl/… auto-compact
 ```
 
-### Format & output compactors
+### Read & compact content
 
-Tokenade includes a family of format-aware compactors — the full list is in
-the [CLI reference](#-cli-reference--every-command) above. Each reads a file or
-`-` (stdin); when unsure, let Tokenade pick:
+`read` auto-detects a blob's format and dispatches to the right compactor.
+It reads a file or `-` (stdin); live command output is folded the same way
+through `wrap`:
 
 ```sh
-tokenade auto <file>      # auto-detect and compact
-some-noisy-cmd | tokenade auto -   # …or pipe stdin
+tokenade read <file>      # auto-detect and compact
+some-noisy-cmd | tokenade read -   # …or pipe stdin
 
 tokenade add-compactor --file my-rules.toml   # teach Tokenade a new compactor
 tokenade add-compactor --list                 # list the ones you've added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenade/cli",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "description": "Tokenade \u2014 cut your AI coding agent's token bill. Installs the Tokenade CLI (a local, paid token-reduction tool; activate via your browser).",
   "homepage": "https://tokenade.net",
   "license": "UNLICENSED",