shrinker-ai 0.1.0 → 0.3.1

package/.copilot-instructions.md

@@ -1,2 +1,28 @@
 
 
+
+<!-- shrinker agent rules start -->
+Use `shrinker` for high-volume terminal outputs to reduce tokens.
+
+Routing policy:
+- `git status|diff|log|show|reflog|branch|tag|stash` -> `shrinker git ...`
+- `npm test|t|install|i|ci|ls|list` -> `shrinker npm ...`
+- `docker ps|logs|images|compose` -> `shrinker docker ...`
+- `kubectl get|describe|logs` -> `shrinker kubectl ...`
+- `gh pr|issue|run` -> `shrinker gh ...`
+- `rg`, `find`, `tail`, `cat`, `ls`, `dir` -> `shrinker <command> ...`
+
+Bypass shrinker when:
+- command modifies remote state and output volume is already tiny
+- command requires interactive stdin
+- command explicitly needs `shrinker --raw`
+
+Examples:
+- `shrinker git log -n 20`
+- `shrinker rg "pattern" src`
+- `shrinker docker logs api --tail 500`
+<!-- shrinker agent rules end -->
+
+
+
+

package/CLAUDE.md

@@ -1,2 +1,28 @@
 
 
+
+<!-- shrinker agent rules start -->
+Use `shrinker` for high-volume terminal outputs to reduce tokens.
+
+Routing policy:
+- `git status|diff|log|show|reflog|branch|tag|stash` -> `shrinker git ...`
+- `npm test|t|install|i|ci|ls|list` -> `shrinker npm ...`
+- `docker ps|logs|images|compose` -> `shrinker docker ...`
+- `kubectl get|describe|logs` -> `shrinker kubectl ...`
+- `gh pr|issue|run` -> `shrinker gh ...`
+- `rg`, `find`, `tail`, `cat`, `ls`, `dir` -> `shrinker <command> ...`
+
+Bypass shrinker when:
+- command modifies remote state and output volume is already tiny
+- command requires interactive stdin
+- command explicitly needs `shrinker --raw`
+
+Examples:
+- `shrinker git log -n 20`
+- `shrinker rg "pattern" src`
+- `shrinker docker logs api --tail 500`
+<!-- shrinker agent rules end -->
+
+
+
+

package/README.md

@@ -18,53 +18,89 @@ this POC proves that a few conservative, deterministic filters can save useful c
 
 Requires Node.js 22.13 or newer. This is the first Node 22 release where the built-in SQLite module no longer requires an experimental flag.
 
-### One-command install (Windows PowerShell)
+### One-command install (macOS zsh)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/macos/install.sh | bash
+```
 
-Quick one-liner:
+### One-command install (Windows PowerShell)
 
 ```powershell
-irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/install.ps1 | iex
+irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/windows/install.ps1 | iex
 ```
 
-### Package install from npm
+### Install from npm package
 
-The installer downloads the published package from the public npm registry, then installs its local integration files.
+Windows PowerShell:
 
 ```powershell
-irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/install.ps1 | iex
+npm install --global shrinker-ai --registry=https://registry.npmjs.org
+$pkg = Join-Path ((npm root --global).Trim()) "shrinker-ai"
+pwsh -ExecutionPolicy Bypass -File (Join-Path $pkg "integrations\\windows\\install.ps1") -Local -SkipNpmInstall -SkipBuild -SkipLink
 ```
 
-This script installs `shrinker-ai` from `https://registry.npmjs.org` and installs Copilot/Claude rules by default.
+To enable automatic PowerShell routing, add `-EnableProfileRouting` to the final command.
 
-To enable automatic PowerShell routing (so `git log` routes through `shrinker`), download the script and pass the option:
+macOS zsh:
 
-```powershell
-$tmp = Join-Path $env:TEMP "install-shrinker.ps1"
-Invoke-WebRequest "https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/install.ps1" -OutFile $tmp
-pwsh -ExecutionPolicy Bypass -File $tmp -EnableProfileRouting
+```bash
+npm install --global shrinker-ai --registry=https://registry.npmjs.org
+pkg="$(npm root --global)/shrinker-ai"
+bash "$pkg/integrations/macos/install.sh" --local --skip-npm-install --skip-build --skip-link --enable-profile-routing
 ```
 
-For a local checkout, use the complete installer without profile routing:
+### Install from local checkout
+
+Windows PowerShell:
 
 ```powershell
-pwsh -ExecutionPolicy Bypass -File .\integrations\install-shrinker.ps1
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\install.ps1 -Local
+```
+
+macOS zsh:
+
+```bash
+bash ./integrations/macos/install.sh --local
 ```
 
-This writes managed guidance blocks to:
+This writes managed guidance blocks globally to:
 
-- `.copilot-instructions.md`
-- `CLAUDE.md`
+- `~/.copilot/copilot-instructions.md`
+- `~/.claude/CLAUDE.md`
 
-The shared guidance source is `templates/agent-rules.md`; the two files above are generated in the target project.
+The shared guidance source is `templates/agent-rules.md`; the files above are created in the corresponding global agent directory.
 
 The rules tell agents to prefer `shrinker <command>` for high-volume commands while leaving native commands untouched.
 
-### Remote package uninstall
+### Uninstall
+
+If you installed from npm, remove the package first:
+
+```bash
+npm uninstall --global shrinker-ai --registry=https://registry.npmjs.org
+```
+
+If you also installed profile/rules through the package scripts, run the matching local uninstaller from the installed package before uninstalling:
 
-Quick one-liner:
+Windows PowerShell:
 
 ```powershell
-irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/uninstall.ps1 | iex
+$pkg = Join-Path ((npm root --global).Trim()) "shrinker-ai"
+pwsh -ExecutionPolicy Bypass -File (Join-Path $pkg "integrations\\windows\\uninstall.ps1") -SkipUnlink
+```
+
+macOS zsh:
+
+```bash
+pkg="$(npm root --global)/shrinker-ai"
+bash "$pkg/integrations/macos/uninstall.sh" --skip-unlink
+```
+
+macOS one-liner uninstall:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/macos/uninstall.sh | bash
 ```
 
 ### Local repo install/uninstall (contributors)
@@ -72,26 +108,48 @@ irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations
 If you cloned this repository and want to run scripts directly from the local path:
 
 ```powershell
-pwsh -ExecutionPolicy Bypass -File .\integrations\install-shrinker.ps1
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\install.ps1 -Local
+```
+
+Or on macOS:
+
+```bash
+bash ./integrations/macos/install.sh --local
 ```
 
 To uninstall:
 
 ```powershell
-pwsh -ExecutionPolicy Bypass -File .\integrations\uninstall-shrinker.ps1
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\install.ps1 -Uninstall
+```
+
+Or on macOS:
+
+```bash
+bash ./integrations/macos/install.sh --uninstall
 ```
 
 Uninstall options:
 
 ```powershell
-# Remove only profile routing, keep shrinker command installed
-pwsh -ExecutionPolicy Bypass -File .\integrations\uninstall-shrinker.ps1 -SkipUnlink
+# Keep shrinker command installed, but remove profile integration and managed rules
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\install.ps1 -Uninstall -SkipUnlink
+
+# Keep managed rules files unchanged while uninstalling command/profile hooks
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\install.ps1 -Uninstall -SkipAgentRules
+```
+
+macOS uninstall options:
 
-# Remove managed Copilot/Claude rules block only
-pwsh -ExecutionPolicy Bypass -File .\integrations\uninstall-shrinker.ps1 -SkipUnlink
+```bash
+# Keep shrinker command installed, but remove profile integration and managed rules
+bash ./integrations/macos/install.sh --uninstall --skip-unlink
+
+# Keep managed rules files unchanged while uninstalling command/profile hooks
+bash ./integrations/macos/install.sh --uninstall --skip-agent-rules
 ```
 
-If your current terminal had already loaded `shrinker-profile.ps1`, restart terminal (or remove loaded wrapper functions) to fully return to native command behavior.
+If your current terminal had already loaded `shrinker-profile.ps1` or `shrinker-profile.zsh`, restart terminal (or remove loaded wrapper functions) to fully return to native command behavior.
 
 ```powershell
 npm install
@@ -144,11 +202,21 @@ if (!(Test-Path $PROFILE)) {
     New-Item -ItemType File -Path $PROFILE -Force | Out-Null
 }
 
-$integration = (Resolve-Path .\integrations\shrinker-profile.ps1).Path
+$integration = (Resolve-Path .\integrations\windows\shrinker-profile.ps1).Path
 Add-Content $PROFILE "`n. `"$integration`""
 . $PROFILE
 ```
 
+macOS zsh profile integration:
+
+```bash
+echo '' >> ~/.zshrc
+echo '# >>> shrinker integration >>>' >> ~/.zshrc
+echo 'source "'"$(pwd)/integrations/macos/shrinker-profile.zsh"'"' >> ~/.zshrc
+echo '# <<< shrinker integration <<<' >> ~/.zshrc
+source ~/.zshrc
+```
+
 The default rules are:
 
 ```text
@@ -164,7 +232,7 @@ rg/find/tail/cat/ls/dir -> shrinker <command>
 git push, git fetch, and all other commands -> native executable
 ```
 
-Edit `$global:ShrinkPowerShellRules` in `integrations\shrinker-profile.ps1` to change the allowlist. The router is now option-aware for common global flags, so forms like `git -C <path> log` and `kubectl --context prod get pods` are routed correctly.
+Edit `$global:ShrinkPowerShellRules` in `integrations\windows\shrinker-profile.ps1` to change the allowlist. The router is now option-aware for common global flags, so forms like `git -C <path> log` and `kubectl --context prod get pods` are routed correctly.
 
 ## Savings statistics
 

package/integrations/macos/install.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PACKAGE_NAME="shrinker-ai"
+REGISTRY="https://registry.npmjs.org"
+VERSION=""
+LOCAL=0
+SKIP_NPM_INSTALL=0
+SKIP_BUILD=0
+SKIP_LINK=0
+ENABLE_PROFILE_ROUTING=0
+SKIP_PROFILE=0
+SKIP_AGENT_RULES=0
+COPILOT_ONLY=0
+CLAUDE_ONLY=0
+PROFILE_PATH="${PROFILE_PATH:-$HOME/.zshrc}"
+STEP=0
+
+print_message() {
+  local emoji="$1"
+  local message="$2"
+  STEP=$((STEP + 1))
+  printf '%d. %s %s\n' "$STEP" "$emoji" "$message"
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --local) LOCAL=1 ;;
+    --package-name) PACKAGE_NAME="${2:-}"; shift ;;
+    --registry) REGISTRY="${2:-}"; shift ;;
+    --version) VERSION="${2:-}"; shift ;;
+    --skip-npm-install) SKIP_NPM_INSTALL=1 ;;
+    --skip-build) SKIP_BUILD=1 ;;
+    --skip-link) SKIP_LINK=1 ;;
+    --enable-profile-routing) ENABLE_PROFILE_ROUTING=1 ;;
+    --skip-profile) SKIP_PROFILE=1 ;;
+    --skip-agent-rules) SKIP_AGENT_RULES=1 ;;
+    --copilot-only) COPILOT_ONLY=1 ;;
+    --claude-only) CLAUDE_ONLY=1 ;;
+    --profile-path) PROFILE_PATH="${2:-}"; shift ;;
+    *) print_message "❌" "Unknown option: $1" >&2; exit 1 ;;
+  esac
+  shift
+done
+
+if (( ENABLE_PROFILE_ROUTING == 1 && SKIP_PROFILE == 1 )); then print_message "❌" "Use either --enable-profile-routing or --skip-profile, not both." >&2; exit 1; fi
+if (( COPILOT_ONLY == 1 && CLAUDE_ONLY == 1 )); then print_message "❌" "Use either --copilot-only or --claude-only, not both." >&2; exit 1; fi
+
+if (( LOCAL == 0 )); then
+  package_spec="$PACKAGE_NAME"
+  [[ -z "$VERSION" ]] || package_spec="$PACKAGE_NAME@$VERSION"
+  print_message "📦" "Installing $package_spec from $REGISTRY..."
+  npm install --silent --global "$package_spec" "--registry=$REGISTRY"
+  package_root="$(npm root --global)/$PACKAGE_NAME"
+  entrypoint="$package_root/integrations/macos/install.sh"
+  [[ -f "$entrypoint" ]] || { print_message "❌" "Installed package installer not found: $entrypoint" >&2; exit 1; }
+  bash "$entrypoint" --local --skip-npm-install --skip-build --skip-link \
+    $( (( ENABLE_PROFILE_ROUTING )) && echo --enable-profile-routing ) \
+    $( (( SKIP_PROFILE )) && echo --skip-profile ) \
+    $( (( SKIP_AGENT_RULES )) && echo --skip-agent-rules ) \
+    $( (( COPILOT_ONLY )) && echo --copilot-only ) \
+    $( (( CLAUDE_ONLY )) && echo --claude-only ) \
+    --profile-path "$PROFILE_PATH"
+  exit 0
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+TEMPLATE_PATH="$REPO_ROOT/templates/agent-rules.md"
+INTEGRATION_PATH="$SCRIPT_DIR/shrinker-profile.zsh"
+BLOCK_START="<!-- shrinker agent rules start -->"
+BLOCK_END="<!-- shrinker agent rules end -->"
+
+node_version_raw="$(node -v 2>/dev/null || true)"
+[[ -n "$node_version_raw" ]] || { print_message "❌" "Node.js was not found on PATH. Install Node.js 22.13+ first." >&2; exit 1; }
+node_version="${node_version_raw#v}"
+IFS='.' read -r node_major node_minor _ <<< "$node_version"
+(( node_major > 22 || (node_major == 22 && node_minor >= 13) )) || { print_message "❌" "Node.js 22.13+ is required. Found $node_version_raw" >&2; exit 1; }
+
+set_agent_rules() {
+  local target="$1"
+  local body="$2"
+  local block="$BLOCK_START"$'\n'"$body"$'\n'"$BLOCK_END"
+  mkdir -p "$(dirname "$target")"
+  if [[ -f "$target" ]] && grep -Fq "$BLOCK_START" "$target" && grep -Fq "$BLOCK_END" "$target"; then
+    local block_file
+    block_file="$(mktemp "$(dirname "$target")/.shrinker-rules.XXXXXX")"
+    printf '%s\n' "$block" > "$block_file"
+    awk -v start="$BLOCK_START" -v end="$BLOCK_END" -v block_file="$block_file" '
+      function print_block(line) {
+        while ((getline line < block_file) > 0) print line
+        close(block_file)
+      }
+      {
+        if (index($0, start) > 0) {
+          if (!replaced) print_block()
+          replaced = 1
+          inblock = 1
+          next
+        }
+        if (inblock && index($0, end) > 0) {
+          inblock = 0
+          next
+        }
+        if (!inblock) print
+      }
+    ' "$target" > "$target.tmp"
+    rm -f "$block_file"
+    mv "$target.tmp" "$target"
+  elif [[ -f "$target" ]]; then printf '\n%s\n' "$block" >> "$target"
+  else printf '%s\n' "$block" > "$target"; fi
+  print_message "📄" "Installed managed rules in: $target"
+}
+
+add_profile_integration() {
+  local profile_file="$1"
+  mkdir -p "$(dirname "$profile_file")"; touch "$profile_file"
+  if ! grep -Fq '# >>> shrinker integration >>>' "$profile_file"; then
+    printf '\n# >>> shrinker integration >>>\nsource "%s"\n# <<< shrinker integration <<<\n\n' "$INTEGRATION_PATH" >> "$profile_file"
+  fi
+}
+
+print_message "📦" "Installing shrinker from: $REPO_ROOT"
+pushd "$REPO_ROOT" >/dev/null
+if (( SKIP_NPM_INSTALL == 0 )); then
+  print_message "📥" "Installing dependencies..."
+  npm install --silent
+fi
+if (( SKIP_BUILD == 0 )); then
+  print_message "🏗️" "Building shrinker..."
+  npm run build --silent
+fi
+if (( SKIP_LINK == 0 )); then
+  print_message "🔗" "Linking shrinker globally..."
+  npm link --silent
+fi
+popd >/dev/null
+
+if (( SKIP_PROFILE == 0 && ENABLE_PROFILE_ROUTING == 1 )); then add_profile_integration "$PROFILE_PATH"; fi
+if (( SKIP_AGENT_RULES == 0 )); then
+  [[ -f "$TEMPLATE_PATH" ]] || { print_message "❌" "Agent rules template not found: $TEMPLATE_PATH" >&2; exit 1; }
+  rules_body="$(cat "$TEMPLATE_PATH")"
+  (( CLAUDE_ONLY )) || set_agent_rules "$HOME/.copilot/copilot-instructions.md" "$rules_body"
+  (( COPILOT_ONLY )) || set_agent_rules "$HOME/.claude/CLAUDE.md" "$rules_body"
+fi
+
+print_message "✅" "Install complete."
+echo ""
+echo "💡 Try: shrinker help"

package/integrations/macos/shrinker-profile.zsh

@@ -0,0 +1,98 @@
+typeset -gA SHRINK_RULES
+SHRINK_RULES=(
+  git "status diff log show reflog branch tag stash"
+  npm "test t install i ci ls list"
+  docker "ps logs images compose"
+  kubectl "get describe logs"
+  gh "pr issue run"
+  rg "*"
+  find "*"
+  tail "*"
+  cat "*"
+  ls "*"
+)
+
+typeset -gA SHRINK_OPTION_VALUE_FLAGS
+SHRINK_OPTION_VALUE_FLAGS=(
+  git "-C -c --git-dir --work-tree --namespace"
+  npm "--prefix --cache --registry --workspace --userconfig -w -C"
+  docker "-H --host --context --config"
+  kubectl "-n --namespace -o --output --context --kubeconfig --cluster --user"
+  gh "-R --repo"
+)
+
+_shrink_get_subcommand() {
+  local cmd="$1"
+  shift
+
+  local -a args
+  args=("$@")
+
+  local -a value_flags
+  value_flags=(${=SHRINK_OPTION_VALUE_FLAGS[$cmd]})
+
+  local i part
+  i=1
+  while (( i <= ${#args[@]} )); do
+    part="${args[$i]}"
+    if [[ -z "$part" ]]; then
+      (( i++ ))
+      continue
+    fi
+
+    if (( ${value_flags[(Ie)$part]} > 0 )); then
+      (( i += 2 ))
+      continue
+    fi
+
+    if [[ "$part" == -* ]]; then
+      (( i++ ))
+      continue
+    fi
+
+    print -r -- "${part:l}"
+    return 0
+  done
+
+  print -r -- ""
+}
+
+_shrink_should_route() {
+  local cmd="$1"
+  shift
+
+  local rules="${SHRINK_RULES[$cmd]}"
+  [[ -z "$rules" ]] && return 1
+  [[ "$rules" == *"*"* ]] && return 0
+
+  local subcommand
+  subcommand="$(_shrink_get_subcommand "$cmd" "$@")"
+  [[ -z "$subcommand" ]] && return 1
+
+  local -a allowlist
+  allowlist=(${=rules})
+  (( ${allowlist[(Ie)$subcommand]} > 0 ))
+}
+
+_shrink_invoke_or_native() {
+  local cmd="$1"
+  shift
+
+  if _shrink_should_route "$cmd" "$@" && command -v shrinker >/dev/null 2>&1; then
+    command shrinker "$cmd" "$@"
+    return $?
+  fi
+
+  command "$cmd" "$@"
+}
+
+git() { _shrink_invoke_or_native git "$@"; }
+npm() { _shrink_invoke_or_native npm "$@"; }
+docker() { _shrink_invoke_or_native docker "$@"; }
+kubectl() { _shrink_invoke_or_native kubectl "$@"; }
+gh() { _shrink_invoke_or_native gh "$@"; }
+rg() { _shrink_invoke_or_native rg "$@"; }
+find() { _shrink_invoke_or_native find "$@"; }
+tail() { _shrink_invoke_or_native tail "$@"; }
+cat() { _shrink_invoke_or_native cat "$@"; }
+ls() { _shrink_invoke_or_native ls "$@"; }

package/integrations/macos/uninstall.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+INSTALL_DIR="${HOME}/.shrinker-src"
+REMOVE_INSTALL_DIR=0
+SKIP_UNLINK=0
+SKIP_AGENT_RULES=0
+COPILOT_ONLY=0
+CLAUDE_ONLY=0
+PROFILE_PATH="${PROFILE_PATH:-$HOME/.zshrc}"
+UNINSTALL_STEP=0
+
+print_step() {
+  local emoji="$1" message="$2"
+  UNINSTALL_STEP=$((UNINSTALL_STEP + 1))
+  printf '%d. %s %s\n' "$UNINSTALL_STEP" "$emoji" "$message"
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --skip-unlink) SKIP_UNLINK=1 ;;
+    --skip-agent-rules) SKIP_AGENT_RULES=1 ;;
+    --copilot-only) COPILOT_ONLY=1 ;;
+    --claude-only) CLAUDE_ONLY=1 ;;
+    --profile-path) PROFILE_PATH="${2:-}"; shift ;;
+    --install-dir) INSTALL_DIR="${2:-}"; shift ;;
+    --remove-install-dir) REMOVE_INSTALL_DIR=1 ;;
+    *) echo "Unknown option: $1" >&2; exit 1 ;;
+  esac
+  shift
+done
+
+if (( COPILOT_ONLY == 1 && CLAUDE_ONLY == 1 )); then echo "Use either --copilot-only or --claude-only, not both." >&2; exit 1; fi
+BLOCK_START="<!-- shrinker agent rules start -->"
+BLOCK_END="<!-- shrinker agent rules end -->"
+
+remove_agent_rules() {
+  local target="$1"
+  [[ -f "$target" ]] || return 0
+  awk -v start="$BLOCK_START" -v end="$BLOCK_END" 'BEGIN{inblock=0} {if(index($0,start)>0){inblock=1;next} if(inblock&&index($0,end)>0){inblock=0;next} if(!inblock)print}' "$target" > "$target.tmp"
+  mv "$target.tmp" "$target"
+}
+
+remove_profile_integration() {
+  local profile_file="$1"
+  [[ -f "$profile_file" ]] || return 0
+  awk -v start='# >>> shrinker integration >>>' -v end='# <<< shrinker integration <<<' 'BEGIN{inblock=0} {if(index($0,start)>0){inblock=1;next} if(inblock&&index($0,end)>0){inblock=0;next} if(!inblock)print}' "$profile_file" > "$profile_file.tmp"
+  mv "$profile_file.tmp" "$profile_file"
+}
+
+if (( SKIP_UNLINK == 0 )); then
+  print_step "🔗" "Unlinking shrinker globally..."
+  npm unlink --silent --global shrinker-ai
+else
+  print_step "⏭️" "Skipped global npm unlink."
+fi
+print_step "🔧" "Removing shell profile integration..."
+remove_profile_integration "$PROFILE_PATH"
+if (( SKIP_AGENT_RULES == 0 )); then
+  (( CLAUDE_ONLY )) || remove_agent_rules "$HOME/.copilot/copilot-instructions.md"
+  (( COPILOT_ONLY )) || remove_agent_rules "$HOME/.claude/CLAUDE.md"
+else
+  print_step "⏭️" "Skipped managed agent rules."
+fi
+print_step "✅" "Uninstall complete."
+
+if (( REMOVE_INSTALL_DIR == 1 )) && [[ -d "$INSTALL_DIR" ]]; then
+  rm -rf "$INSTALL_DIR"
+  print_step "🧹" "Removed install directory: $INSTALL_DIR"
+fi

package/integrations/windows/install.ps1

@@ -0,0 +1,113 @@
+param(
+    [switch]$Local,
+    [string]$PackageName = "shrinker-ai",
+    [string]$Registry = "https://registry.npmjs.org",
+    [string]$Version,
+    [switch]$SkipNpmInstall,
+    [switch]$SkipBuild,
+    [switch]$SkipLink,
+    [switch]$EnableProfileRouting,
+    [switch]$SkipProfile,
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly,
+    [string]$ProfilePath = $PROFILE
+)
+
+$ErrorActionPreference = "Stop"
+$InstallStep = 0
+
+function Write-InstallStep {
+    param([string]$Emoji, [string]$Message)
+    $script:InstallStep++
+    Write-Host "$($script:InstallStep). $Emoji $Message"
+}
+
+if ($EnableProfileRouting -and $SkipProfile) { throw "Use either -EnableProfileRouting or -SkipProfile, not both." }
+if ($CopilotOnly -and $ClaudeOnly) { throw "Use either -CopilotOnly or -ClaudeOnly, not both." }
+
+function Set-AgentRules {
+    param([string]$Body)
+    $start = "<!-- shrinker agent rules start -->"
+    $end = "<!-- shrinker agent rules end -->"
+    foreach ($target in @((Join-Path $HOME ".copilot\copilot-instructions.md"), (Join-Path $HOME ".claude\CLAUDE.md"))) {
+        if ($ClaudeOnly -and $target.EndsWith(".copilot-instructions.md")) { continue }
+        if ($CopilotOnly -and $target.EndsWith("CLAUDE.md")) { continue }
+        New-Item -ItemType Directory -Path (Split-Path $target) -Force | Out-Null
+        $content = if (Test-Path $target) { Get-Content $target -Raw } else { "" }
+        $block = "$start`n$Body`n$end"
+        if ($null -ne $content -and $content.Contains($start) -and $content.Contains($end)) {
+            $content = [regex]::Replace($content, [regex]::Escape($start) + ".*?" + [regex]::Escape($end), $block, 'Singleline')
+            Set-Content $target $content
+        } elseif ($content) { Add-Content $target "`n$block`n" }
+        else { Set-Content $target "$block`n" }
+        Write-InstallStep "📄" "Installed managed rules in: $target"
+    }
+}
+
+function Add-ProfileIntegration {
+    param([string]$ProfileFile, [string]$IntegrationFile)
+    if (-not (Test-Path $ProfileFile)) { New-Item -ItemType File -Path $ProfileFile -Force | Out-Null }
+    $start = "# >>> shrinker integration >>>"
+    if ((Get-Content $ProfileFile -Raw).Contains($start)) { return }
+    Add-Content $ProfileFile "`n$start`n. `"$IntegrationFile`"`n# <<< shrinker integration <<<`n"
+    Write-InstallStep "🔧" "Added shrinker integration block to profile: $ProfileFile"
+}
+
+if (-not $Local) {
+    $packageSpec = if ($Version) { "$PackageName@$Version" } else { $PackageName }
+    Write-InstallStep "📦" "Installing $packageSpec from $Registry..."
+    & npm install --silent --global $packageSpec "--registry=$Registry"
+    if ($LASTEXITCODE -ne 0) { throw "npm package installation failed." }
+    Write-InstallStep "🔎" "Locating the installed package..."
+    $globalRoot = (& npm root --global).Trim()
+    if (-not $globalRoot) { throw "Could not determine the global npm package directory." }
+    $packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
+    $entrypoint = Join-Path $packageRoot "integrations\windows\install.ps1"
+    if (-not (Test-Path $entrypoint)) { throw "Installed package installer not found: $entrypoint" }
+    Write-InstallStep "⚙️" "Configuring the installed package..."
+    & pwsh -ExecutionPolicy Bypass -File $entrypoint -Local -SkipNpmInstall -SkipBuild -SkipLink -EnableProfileRouting:$EnableProfileRouting -SkipProfile:$SkipProfile -SkipAgentRules:$SkipAgentRules -CopilotOnly:$CopilotOnly -ClaudeOnly:$ClaudeOnly -ProfilePath $ProfilePath
+    if ($LASTEXITCODE -ne 0) { throw "Repository installer failed with exit code $LASTEXITCODE" }
+    Write-InstallStep "✅" "Install complete."
+    exit 0
+}
+
+$scriptDir = $PSScriptRoot
+$repoRoot = (Resolve-Path (Join-Path $scriptDir "..\..")).Path
+$templatePath = Join-Path $repoRoot "templates\agent-rules.md"
+$integrationPath = (Resolve-Path (Join-Path $scriptDir "shrinker-profile.ps1")).Path
+if (-not $SkipAgentRules) {
+    if (-not (Test-Path $templatePath)) { throw "Agent rules template not found: $templatePath" }
+    $rulesBody = Get-Content $templatePath -Raw
+}
+
+$versionText = & node -v 2>$null
+if (-not $versionText) { throw "Node.js was not found on PATH. Install Node.js 22.13+ first." }
+$version = [version]($versionText.TrimStart('v'))
+if ($version -lt [version]'22.13.0') { throw "Node.js 22.13+ is required. Found $versionText" }
+
+Push-Location $repoRoot
+try {
+    Write-InstallStep "📦" "Installing shrinker from: $repoRoot"
+    if (-not $SkipNpmInstall) {
+        Write-InstallStep "📥" "Installing dependencies..."
+        & npm install --silent
+        if ($LASTEXITCODE -ne 0) { throw "npm install failed." }
+    }
+    if (-not $SkipBuild) {
+        Write-InstallStep "🏗️" "Building shrinker..."
+        & npm run build --silent
+        if ($LASTEXITCODE -ne 0) { throw "npm run build failed." }
+    }
+    if (-not $SkipLink) {
+        Write-InstallStep "🔗" "Linking shrinker globally..."
+        & npm link --silent
+        if ($LASTEXITCODE -ne 0) { throw "npm link failed." }
+    }
+} finally { Pop-Location }
+
+if (-not $SkipProfile -and $EnableProfileRouting) { Add-ProfileIntegration $ProfilePath $integrationPath }
+if (-not $SkipAgentRules) { Set-AgentRules $rulesBody }
+Write-InstallStep "✅" "Install complete."
+Write-Host " "
+Write-Host "💡 Try: shrinker help"

package/integrations/windows/uninstall.ps1

@@ -0,0 +1,57 @@
+param(
+    [switch]$SkipUnlink,
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly,
+    [string]$ProfilePath = $PROFILE
+)
+
+$ErrorActionPreference = "Stop"
+$UninstallStep = 0
+
+function Write-UninstallStep {
+    param([string]$Emoji, [string]$Message)
+    $script:UninstallStep++
+    Write-Host "$($script:UninstallStep). $Emoji $Message"
+}
+
+function Remove-AgentRules {
+    param([string]$Path)
+    if (-not (Test-Path $Path)) { return }
+    $content = Get-Content $Path -Raw
+    $start = "<!-- shrinker agent rules start -->"
+    $end = "<!-- shrinker agent rules end -->"
+    if ($null -ne $content -and $content.Contains($start) -and $content.Contains($end)) {
+        $pattern = [regex]::Escape($start) + ".*?" + [regex]::Escape($end)
+        Set-Content $Path ([regex]::Replace($content, $pattern, "", 'Singleline').TrimEnd() + "`n")
+        Write-UninstallStep "📄" "Removed managed rules from: $Path"
+    }
+}
+
+function Remove-ProfileIntegration {
+    param([string]$ProfileFile)
+    if (-not (Test-Path $ProfileFile)) { return }
+    $content = Get-Content $ProfileFile -Raw
+    if ($null -eq $content) { return }
+    $start = $content.IndexOf("# >>> shrinker integration >>>")
+    $endMarker = "# <<< shrinker integration <<<"
+    if ($start -ge 0) {
+        $end = $content.IndexOf($endMarker, $start)
+        if ($end -ge 0) { Set-Content $ProfileFile $content.Remove($start, $end + $endMarker.Length - $start) }
+    }
+}
+
+if (-not $SkipUnlink) {
+    Write-UninstallStep "🔗" "Unlinking shrinker globally..."
+    & npm unlink --silent --global shrinker-ai
+    if ($LASTEXITCODE -ne 0) { throw "npm unlink failed." }
+}
+else { Write-UninstallStep "⏭️" "Skipped global npm unlink." }
+Write-UninstallStep "🔧" "Removing PowerShell profile integration..."
+Remove-ProfileIntegration $ProfilePath
+if (-not $SkipAgentRules) {
+    if (-not $ClaudeOnly) { Remove-AgentRules (Join-Path $HOME ".copilot\copilot-instructions.md") }
+    if (-not $CopilotOnly) { Remove-AgentRules (Join-Path $HOME ".claude\CLAUDE.md") }
+}
+else { Write-UninstallStep "⏭️" "Skipped managed agent rules." }
+Write-UninstallStep "✅" "Uninstall complete."

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "shrinker-ai",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Local deterministic command-output shrinker for coding agents",
   "type": "module",
   "bin": {
-    "shrinker": "./dist/src/cli.js"
+    "shrinker": "dist/src/cli.js"
   },
   "scripts": {
     "start": "tsc -w -p tsconfig.json",
@@ -12,10 +12,14 @@
     "pack": "npm run build --silent && npm pack",
     "test": "npm run build --silent && node --test \"dist/tests/*.test.js\"",
     "demo": "npm run build --silent && node dist/demo/run-demo.js",
-    "install:local": "pwsh -ExecutionPolicy Bypass -File ./integrations/install-shrinker.ps1",
-    "uninstall:local": "pwsh -ExecutionPolicy Bypass -File ./integrations/uninstall-shrinker.ps1",
-    "install:package": "pwsh -ExecutionPolicy Bypass -File ./integrations/install.ps1",
-    "uninstall:package": "pwsh -ExecutionPolicy Bypass -File ./integrations/uninstall.ps1"
+    "install:local": "pwsh -ExecutionPolicy Bypass -File ./integrations/windows/install.ps1 -Local",
+    "install:local:macos": "./integrations/macos/install.sh --local",
+    "install:github": "pwsh -ExecutionPolicy Bypass -File ./integrations/windows/install.ps1",
+    "install:github:macos": "./integrations/macos/install.sh",
+    "uninstall:local": "pwsh -ExecutionPolicy Bypass -File ./integrations/windows/uninstall.ps1",
+    "uninstall:local:macos": "./integrations/macos/uninstall.sh",
+    "uninstall:github": "pwsh -ExecutionPolicy Bypass -File ./integrations/windows/uninstall.ps1",
+    "uninstall:github:macos": "./integrations/macos/uninstall.sh"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -27,5 +31,9 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ivanduplenskikh/shrinker.git"
+  }
 }

package/integrations/install-shrinker.ps1

@@ -1,166 +0,0 @@
-param(
-    [switch]$SkipNpmInstall,
-    [switch]$SkipBuild,
-    [switch]$SkipLink,
-    [switch]$EnableProfileRouting,
-    [switch]$SkipProfile,
-    [switch]$SkipAgentRules,
-    [switch]$CopilotOnly,
-    [switch]$ClaudeOnly,
-    [string]$ProfilePath = $PROFILE
-)
-
-$ErrorActionPreference = "Stop"
-
-if ($EnableProfileRouting -and $SkipProfile) {
-    throw "Use either -EnableProfileRouting or -SkipProfile, not both."
-}
-if ($CopilotOnly -and $ClaudeOnly) {
-    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
-}
-
-$blockStart = "<!-- shrinker agent rules start -->"
-$blockEnd = "<!-- shrinker agent rules end -->"
-
-function Set-AgentRules {
-    param(
-        [string]$RepoRoot,
-        [string]$Body
-    )
-
-    $targets = @()
-    if (-not $ClaudeOnly) { $targets += (Join-Path $RepoRoot ".copilot-instructions.md") }
-    if (-not $CopilotOnly) { $targets += (Join-Path $RepoRoot "CLAUDE.md") }
-
-    foreach ($target in $targets) {
-        $content = if (Test-Path $target) { Get-Content -Path $target -Raw } else { "" }
-        $newBlock = "$blockStart`n$Body`n$blockEnd"
-        if ($content -and $content.Contains($blockStart) -and $content.Contains($blockEnd)) {
-            $pattern = [regex]::Escape($blockStart) + ".*?" + [regex]::Escape($blockEnd)
-            $content = [regex]::Replace($content, $pattern, $newBlock, [System.Text.RegularExpressions.RegexOptions]::Singleline)
-            Set-Content -Path $target -Value $content
-        } elseif ($content) {
-            Add-Content -Path $target -Value "`n$newBlock`n"
-        } else {
-            Set-Content -Path $target -Value "$newBlock`n"
-        }
-        Write-Host "Installed managed rules in: $target"
-    }
-}
-
-function Test-NodeVersion {
-    $versionText = & node -v 2>$null
-    if (-not $versionText) {
-        throw "Node.js was not found on PATH. Install Node.js 22.13+ first."
-    }
-
-    $match = [regex]::Match($versionText, "^v(\d+)\.(\d+)\.(\d+)$")
-    if (-not $match.Success) {
-        throw "Could not parse Node.js version: $versionText"
-    }
-
-    $major = [int]$match.Groups[1].Value
-    $minor = [int]$match.Groups[2].Value
-    $patch = [int]$match.Groups[3].Value
-
-    if ($major -lt 22 -or ($major -eq 22 -and $minor -lt 13)) {
-        throw "Node.js 22.13+ is required. Found $versionText"
-    }
-
-    return $versionText
-}
-
-function Add-ProfileIntegration {
-    param(
-        [string]$ProfileFile,
-        [string]$IntegrationFile
-    )
-
-    if (-not (Test-Path $ProfileFile)) {
-        New-Item -ItemType File -Path $ProfileFile -Force | Out-Null
-    }
-
-    $startMarker = "# >>> shrinker integration >>>"
-    $endMarker = "# <<< shrinker integration <<<"
-
-    $existing = Get-Content -Path $ProfileFile -Raw -ErrorAction SilentlyContinue
-    if ($existing -and $existing.Contains($startMarker)) {
-        Write-Host "Profile already contains shrinker integration block: $ProfileFile"
-        return
-    }
-
-    $block = @"
-$startMarker
-. "$IntegrationFile"
-$endMarker
-"@
-
-    Add-Content -Path $ProfileFile -Value "`n$block`n"
-    Write-Host "Added shrinker integration block to profile: $ProfileFile"
-}
-
-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$templatePath = Join-Path $scriptDir "..\templates\agent-rules.md"
-$repoRoot = Resolve-Path (Join-Path $scriptDir "..")
-$integrationPath = (Resolve-Path (Join-Path $scriptDir "shrinker-profile.ps1")).Path
-
-if (-not $SkipAgentRules) {
-    if (-not (Test-Path $templatePath)) {
-        throw "Agent rules template not found: $templatePath"
-    }
-    $rulesBody = Get-Content -Path $templatePath -Raw
-}
-
-Write-Host "Installing shrinker from: $repoRoot"
-$nodeVersion = Test-NodeVersion
-Write-Host "Detected Node.js: $nodeVersion"
-
-Push-Location $repoRoot
-try {
-    if (-not $SkipNpmInstall) {
-        Write-Host "Running npm install..."
-        & npm install
-        if ($LASTEXITCODE -ne 0) {
-            throw "npm install failed with exit code $LASTEXITCODE"
-        }
-    }
-
-    if (-not $SkipBuild) {
-        Write-Host "Running npm run build..."
-        & npm run build --silent
-        if ($LASTEXITCODE -ne 0) {
-            throw "npm run build failed with exit code $LASTEXITCODE"
-        }
-    }
-
-    if (-not $SkipLink) {
-        Write-Host "Running npm link..."
-        & npm link
-        if ($LASTEXITCODE -ne 0) {
-            throw "npm link failed with exit code $LASTEXITCODE"
-        }
-    }
-}
-finally {
-    Pop-Location
-}
-
-if (-not $SkipProfile) {
-    if ($EnableProfileRouting) {
-        Add-ProfileIntegration -ProfileFile $ProfilePath -IntegrationFile $integrationPath
-        Write-Host "Reload your profile with: . `$PROFILE"
-    }
-    else {
-        Write-Host "Profile routing not enabled (default). Native commands remain unchanged."
-        Write-Host "To enable routing later: pwsh -ExecutionPolicy Bypass -File .\integrations\install-shrinker.ps1 -SkipNpmInstall -SkipBuild -SkipLink -EnableProfileRouting"
-    }
-}
-else {
-    Write-Host "Profile routing skipped via -SkipProfile. Native commands remain unchanged."
-}
-
-if (-not $SkipAgentRules) {
-    Set-AgentRules -RepoRoot (Get-Location).Path -Body $rulesBody
-}
-
-Write-Host "Install complete. Try: shrinker help"

package/integrations/install.ps1

@@ -1,46 +0,0 @@
-param(
-    [string]$PackageName = "shrinker-ai",
-    [string]$Registry = "https://registry.npmjs.org",
-    [string]$Version,
-    [switch]$EnableProfileRouting,
-    [switch]$SkipAgentRules,
-    [switch]$CopilotOnly,
-    [switch]$ClaudeOnly
-)
-
-$ErrorActionPreference = "Stop"
-
-if ($CopilotOnly -and $ClaudeOnly) {
-    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
-}
-
-$packageSpec = if ($Version) { "$PackageName@$Version" } else { $PackageName }
-Write-Host "Installing $packageSpec from $Registry..."
-& npm install --global $packageSpec "--registry=$Registry"
-if ($LASTEXITCODE -ne 0) {
-    throw "npm package installation failed with exit code $LASTEXITCODE"
-}
-
-$globalRoot = (& npm root --global).Trim()
-if (-not $globalRoot) {
-    throw "Could not determine the global npm package directory."
-}
-
-$packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
-$localInstaller = Join-Path $packageRoot "integrations\install-shrinker.ps1"
-if (-not (Test-Path $localInstaller)) {
-    throw "Installed package integration not found: $localInstaller"
-}
-
-$localArgs = @("-ExecutionPolicy", "Bypass", "-File", $localInstaller, "-SkipNpmInstall", "-SkipBuild", "-SkipLink")
-if ($EnableProfileRouting) { $localArgs += "-EnableProfileRouting" }
-if ($SkipAgentRules) { $localArgs += "-SkipAgentRules" }
-if ($CopilotOnly) { $localArgs += "-CopilotOnly" }
-if ($ClaudeOnly) { $localArgs += "-ClaudeOnly" }
-
-& pwsh @localArgs
-if ($LASTEXITCODE -ne 0) {
-    throw "Installed package integration failed with exit code $LASTEXITCODE"
-}
-
-Write-Host "Package installation complete. Try: shrinker help"

package/integrations/uninstall-shrinker.ps1

@@ -1,79 +0,0 @@
-param(
-    [switch]$SkipUnlink,
-    [switch]$SkipAgentRules,
-    [switch]$CopilotOnly,
-    [switch]$ClaudeOnly,
-    [string]$ProfilePath = $PROFILE
-)
-
-$ErrorActionPreference = "Stop"
-
-if ($CopilotOnly -and $ClaudeOnly) {
-    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
-}
-
-$blockStart = "<!-- shrinker agent rules start -->"
-$blockEnd = "<!-- shrinker agent rules end -->"
-
-function Remove-AgentRules {
-    param([string]$Path)
-
-    if (-not (Test-Path $Path)) { return }
-    $content = Get-Content -Path $Path -Raw
-    if (-not ($content.Contains($blockStart) -and $content.Contains($blockEnd))) { return }
-    $pattern = [regex]::Escape($blockStart) + ".*?" + [regex]::Escape($blockEnd)
-    Set-Content -Path $Path -Value ([regex]::Replace($content, $pattern, "", [System.Text.RegularExpressions.RegexOptions]::Singleline).TrimEnd() + "`n")
-    Write-Host "Removed managed rules from: $Path"
-}
-
-function Remove-ProfileIntegration {
-    param([string]$ProfileFile)
-
-    if (-not (Test-Path $ProfileFile)) {
-        Write-Host "Profile not found: $ProfileFile"
-        return
-    }
-
-    $startMarker = "# >>> shrinker integration >>>"
-    $endMarker = "# <<< shrinker integration <<<"
-    $content = Get-Content -Path $ProfileFile -Raw
-    if ($null -eq $content -or $content.Length -eq 0) {
-        Write-Host "Profile is empty; nothing to remove."
-        return
-    }
-
-    $start = $content.IndexOf($startMarker)
-    if ($start -lt 0) {
-        Write-Host "No shrinker integration block found in profile."
-        return
-    }
-
-    $end = $content.IndexOf($endMarker, $start)
-    if ($end -lt 0) {
-        Write-Host "Integration block start found but end marker is missing; leaving profile unchanged."
-        return
-    }
-
-    $end += $endMarker.Length
-    $updated = $content.Remove($start, $end - $start)
-    Set-Content -Path $ProfileFile -Value $updated
-    Write-Host "Removed shrinker integration block from: $ProfileFile"
-}
-
-if (-not $SkipUnlink) {
-    Write-Host "Running npm unlink -g shrinker..."
-    & npm unlink -g shrinker
-    if ($LASTEXITCODE -ne 0) {
-        throw "npm unlink failed with exit code $LASTEXITCODE"
-    }
-}
-
-Remove-ProfileIntegration -ProfileFile $ProfilePath
-Write-Host "If this terminal previously loaded shrinker-profile.ps1, restart terminal or remove Function:git/Function:rg wrappers from current session."
-
-if (-not $SkipAgentRules) {
-    if (-not $ClaudeOnly) { Remove-AgentRules -Path (Join-Path (Get-Location).Path ".copilot-instructions.md") }
-    if (-not $CopilotOnly) { Remove-AgentRules -Path (Join-Path (Get-Location).Path "CLAUDE.md") }
-}
-
-Write-Host "Uninstall complete."

package/integrations/uninstall.ps1

@@ -1,35 +0,0 @@
-param(
-    [string]$PackageName = "shrinker-ai",
-    [string]$Registry = "https://registry.npmjs.org",
-    [switch]$SkipAgentRules,
-    [switch]$CopilotOnly,
-    [switch]$ClaudeOnly
-)
-
-$ErrorActionPreference = "Stop"
-
-if ($CopilotOnly -and $ClaudeOnly) {
-    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
-}
-
-$globalRoot = (& npm root --global).Trim()
-$packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
-$localUninstaller = Join-Path $packageRoot "integrations\uninstall-shrinker.ps1"
-if (Test-Path $localUninstaller) {
-    $localArgs = @("-ExecutionPolicy", "Bypass", "-File", $localUninstaller, "-SkipUnlink")
-    if ($SkipAgentRules) { $localArgs += "-SkipAgentRules" }
-    if ($CopilotOnly) { $localArgs += "-CopilotOnly" }
-    if ($ClaudeOnly) { $localArgs += "-ClaudeOnly" }
-    & pwsh @localArgs
-    if ($LASTEXITCODE -ne 0) {
-        throw "Installed package integration failed with exit code $LASTEXITCODE"
-    }
-}
-
-Write-Host "Removing $PackageName..."
-& npm uninstall --global $PackageName "--registry=$Registry"
-if ($LASTEXITCODE -ne 0) {
-    throw "npm package removal failed with exit code $LASTEXITCODE"
-}
-
-Write-Host "Package uninstallation complete."