@tokmizer/plugin 0.5.4

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@tokmizer/plugin",
+  "version": "0.5.4",
+  "description": "Tokmizer reduces token consumption for AI coding tools (Claude Code, Codex, Cursor, Aider, Gemini CLI, Cline, Windsurf, Copilot). Cross-OS.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tkr": "dist/bin/tkr.js",
+    "tkr-exec": "dist/bin/tkr-exec.js",
+    "tkr-shim": "dist/bin/tkr-shim.js",
+    "tkr-codex-hook": "dist/bin/tkr-codex-hook.js",
+    "tkr-daemon": "dist/bin/tkr-daemon.js"
+  },
+  "files": [
+    "dist",
+    "codex-plugin",
+    ".claude-plugin",
+    "hooks",
+    "commands",
+    "scripts/install-mac-linux.sh",
+    "scripts/install-windows.ps1",
+    "scripts/README-INSTALL.md",
+    "README.md"
+  ],
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "build": "tsc -p tsconfig.json --noEmit && rm -rf dist && node scripts/bundle.mjs && chmod +x dist/bin/tkr.js dist/bin/tkr-exec.js dist/bin/tkr-shim.js dist/bin/tkr-codex-hook.js dist/bin/tkr-daemon.js",
+    "prepublishOnly": "npm run build && node scripts/check-prod-key.mjs && node scripts/check-version.mjs && node scripts/check-dist-clean.mjs && node scripts/check-pack-clean.mjs && node dist/bin/tkr-exec.js echo dist-smoke-ok && node dist/bin/tkr.js help > /dev/null"
+  },
+  "devDependencies": {
+    "@tokmizer/shared": "0.1.0",
+    "esbuild": "^0.28.0",
+    "smol-toml": "^1.3.0",
+    "zod": "^3.23.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Impulse-Creation/Tokmizer"
+  },
+  "homepage": "https://tokmizer.com",
+  "keywords": [
+    "claude-code",
+    "codex",
+    "cursor",
+    "aider",
+    "gemini-cli",
+    "cline",
+    "windsurf",
+    "copilot",
+    "tokmizer",
+    "plugin",
+    "tokens",
+    "token-optimizer"
+  ],
+  "license": "SEE LICENSE IN LICENSE"
+}

package/scripts/README-INSTALL.md

@@ -0,0 +1,37 @@
+# Installing Tokmizer on any AI coding tool
+
+Tokmizer works with **Claude Code, OpenAI Codex, Cursor, Cline, Aider, Gemini CLI, Windsurf, and GitHub Copilot** — on **macOS, Linux, and Windows**.
+
+For Claude Code and Codex, Tokmizer uses native hook APIs. For every other tool, it uses a universal **shell-shim**: a thin wrapper on common commands (`git`, `npm`, `docker`, etc.) that compresses output before it reaches the model. Because the shim sits on PATH, it works regardless of which IDE or CLI invokes the command.
+
+## macOS / Linux
+
+```bash
+curl -fsSL https://tokmizer.com/install.sh | bash
+# or
+bash scripts/install-mac-linux.sh
+```
+
+## Windows (PowerShell)
+
+```powershell
+iwr -useb https://tokmizer.com/install.ps1 | iex
+# or
+PowerShell -ExecutionPolicy Bypass -File scripts\install-windows.ps1
+```
+
+## Per-tool notes
+
+| Tool          | Adapter         | Setup                                                          |
+|---------------|-----------------|----------------------------------------------------------------|
+| Claude Code   | Native hooks    | `/plugin marketplace add Impulse-Creation/Tokmizer` then `/plugin install tokmizer@tokmizer` |
+| Codex CLI     | Native hook     | `curl -fsSL https://tokmizer.com/install.sh \| bash`           |
+| Cursor        | Shell-shim      | Open a new terminal after install.                             |
+| Cline         | Shell-shim      | Open a new terminal after install.                             |
+| Aider         | Shell-shim      | Open a new terminal after install.                             |
+| Gemini CLI    | Shell-shim      | Open a new terminal after install.                             |
+| Windsurf      | Shell-shim      | Open a new terminal after install.                             |
+| GitHub Copilot| Shell-shim      | Open a new terminal after install.                             |
+| Plain shell   | Shell-shim      | Works out of the box.                                          |
+
+After install, optimization starts automatically. Run `tkr link` to connect a paid account.

package/scripts/install-mac-linux.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+#
+# tokmizer universal install — macOS + Linux
+# Installs shell shims under ~/.tokmizer/shims and adds it to PATH.
+# Works under any AI CLI/IDE that invokes shell (Cursor, Cline, Aider,
+# Gemini CLI, Windsurf, Copilot, plain shell). Native hooks are preferred
+# for Claude Code and Codex (see those plugin manifests separately).
+#
+
+TOKMIZER_HOME="${TOKMIZER_HOME:-$HOME/.tokmizer}"
+SHIMS_DIR="$TOKMIZER_HOME/shims"
+
+err() { printf 'tkr install: %s\n' "$*" >&2; exit 1; }
+log() { printf 'tkr: %s\n' "$*"; }
+
+command -v node >/dev/null 2>&1 || err "Node.js 20+ is required."
+command -v npm  >/dev/null 2>&1 || err "npm is required."
+
+NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]')"
+[ "$NODE_MAJOR" -ge 20 ] || err "Node.js 20+ required (found v$NODE_MAJOR)."
+
+log "Installing @tokmizer/plugin from npm..."
+npm install -g @tokmizer/plugin >/dev/null
+
+mkdir -p "$SHIMS_DIR"
+
+SHIM_ENTRY="$(command -v tkr-shim || true)"
+[ -n "$SHIM_ENTRY" ] || err "tkr-shim not found on PATH after install."
+
+log "Installing shims into $SHIMS_DIR..."
+tkr link --shim --shim-runner "$SHIM_ENTRY" </dev/null || true
+
+# Fallback: directly symlink commands if the wizard didn't.
+COMMANDS="git npm yarn pnpm docker kubectl terraform tofu cargo go mvn gradle rg grep find ls cat tail head ps lsof ssh scp rsync curl wget jq yq make"
+for cmd in $COMMANDS; do
+  target="$SHIMS_DIR/$cmd"
+  if [ ! -e "$target" ]; then
+    ln -sf "$SHIM_ENTRY" "$target"
+    chmod +x "$target" || true
+  fi
+done
+
+# Detect the user's interactive shell rc file.
+RC=""
+case "${SHELL:-}" in
+  */zsh)  RC="$HOME/.zshrc" ;;
+  */bash) RC="$HOME/.bashrc" ;;
+  */fish) RC="$HOME/.config/fish/config.fish" ;;
+  *)      RC="$HOME/.profile" ;;
+esac
+
+MARKER="# tokmizer-shim PATH (managed by tokmizer)"
+if [ -f "$RC" ] && ! grep -Fq "$MARKER" "$RC"; then
+  {
+    printf '\n%s\n' "$MARKER"
+    if [[ "$RC" == *fish* ]]; then
+      printf 'set -gx PATH %s $PATH\n' "$SHIMS_DIR"
+    else
+      printf 'export PATH="%s:$PATH"\n' "$SHIMS_DIR"
+    fi
+  } >> "$RC"
+  log "Added shim PATH to $RC"
+else
+  log "Shim PATH already present (or rc file missing): $RC"
+fi
+
+log "Done. Open a new terminal — optimization starts automatically. Run 'tkr link' to connect a paid account."

package/scripts/install-windows.ps1

@@ -0,0 +1,69 @@
+<#
+.SYNOPSIS
+  Tokmizer universal install — Windows (PowerShell 5.1+ / PowerShell 7+)
+.DESCRIPTION
+  Installs shell shims under $env:USERPROFILE\.tokmizer\shims and prepends
+  that directory to the user PATH. Works under any AI CLI/IDE that invokes
+  shell (Cursor, Cline, Aider, Gemini CLI, Windsurf, Copilot, cmd, pwsh).
+#>
+
+$ErrorActionPreference = "Stop"
+
+function Write-Log([string]$msg) { Write-Host "tkr: $msg" }
+function Fail([string]$msg) { Write-Error "tkr install: $msg"; exit 1 }
+
+# Check Node.js 20+
+try {
+    $nodeMajor = (node -p "process.versions.node.split('.')[0]" 2>$null)
+} catch { Fail "Node.js 20+ is required (not found)." }
+if ([int]$nodeMajor -lt 20) { Fail "Node.js 20+ required (found v$nodeMajor)." }
+
+Write-Log "Installing @tokmizer/plugin from npm..."
+npm install -g @tokmizer/plugin | Out-Null
+
+$home = $env:USERPROFILE
+$tokmizerHome = if ($env:TOKMIZER_HOME) { $env:TOKMIZER_HOME } else { Join-Path $home ".tokmizer" }
+$shimsDir = Join-Path $tokmizerHome "shims"
+New-Item -ItemType Directory -Force -Path $shimsDir | Out-Null
+
+$shimEntry = (Get-Command tkr-shim -ErrorAction SilentlyContinue).Source
+if (-not $shimEntry) { Fail "tkr-shim not found on PATH after install." }
+
+Write-Log "Installing shims into $shimsDir..."
+$commands = @(
+    "git","npm","yarn","pnpm","docker","kubectl","terraform","tofu",
+    "cargo","go","mvn","gradle","rg","grep","find","ls","cat","tail",
+    "head","ps","lsof","ssh","scp","rsync","curl","wget","jq","yq","make"
+)
+foreach ($cmd in $commands) {
+    $target = Join-Path $shimsDir "$cmd.cmd"
+    # Each per-command wrapper hard-codes `--as <cmd>` so the shim runner
+    # knows exactly which binary to spawn instead of falling back to the
+    # first user arg (which would let attackers plant arbitrary names).
+    $content = "@echo off`r`nnode `"$shimEntry`" --as `"$cmd`" %*"
+    $content | Set-Content -Encoding ASCII -Path $target -Force
+}
+
+# Prepend shims dir to user PATH.
+$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+if ($userPath -notmatch [Regex]::Escape($shimsDir)) {
+    $newPath = "$shimsDir;$userPath"
+    [Environment]::SetEnvironmentVariable("Path", $newPath, "User")
+    Write-Log "Added $shimsDir to user PATH."
+} else {
+    Write-Log "Shim PATH already present in user PATH."
+}
+
+# PowerShell profile — update for current session and future sessions.
+$profilePath = $PROFILE.CurrentUserAllHosts
+$marker = "# tokmizer-shim PATH (managed by tokmizer)"
+if (-not (Test-Path $profilePath)) {
+    New-Item -ItemType File -Force -Path $profilePath | Out-Null
+}
+$profileContent = Get-Content -Raw -Path $profilePath -ErrorAction SilentlyContinue
+if ($null -eq $profileContent -or -not $profileContent.Contains($marker)) {
+    Add-Content -Path $profilePath -Value "`r`n$marker`r`n`$env:Path = `"$shimsDir;`" + `$env:Path"
+    Write-Log "Added shim line to PowerShell profile: $profilePath"
+}
+
+Write-Log "Done. Open a new terminal — optimization starts automatically. Run 'tkr link' to connect a paid account."