ashlr-plugin 1.36.4

package/docs/install-prompt.md

@@ -0,0 +1,78 @@
+# Ask Claude Code to install ashlr for you
+
+Copy everything in the fenced block below and paste it into a Claude Code
+session. Claude Code will drive the whole install end-to-end, reload or restart
+included, and report the final `/ashlr-doctor` result back to you.
+
+---
+
+````
+Install the ashlr-plugin for me. Follow these steps in order. Do not skip or
+reorder. Report exactly what happened after each step.
+
+1. Run in a Bash shell:
+     curl -fsSL https://plugin.ashlr.ai/install.sh | bash
+   If it exits non-zero, stop and show me the full stderr. Don't try to
+   work around failures — I want to see them.
+
+2. Run these Claude Code slash commands:
+     /plugin marketplace add ashlrai/ashlr-plugin
+     /plugin install ashlr@ashlr-marketplace
+   If either command errors, show the exact error verbatim and stop.
+
+3. Then run:
+     /reload-plugins
+   This forces Claude Code to pick up the newly installed plugin. If
+   /reload-plugins is unavailable or fails, tell me:
+     "Fully quit and restart Claude Code now, then tell me when you're back."
+   Then stop and wait for me before continuing.
+
+4. Then run:
+     /ashlr-doctor
+   Capture and report the full output. Summarize:
+     - total checks
+     - passes
+     - failures (if any, list each with its message)
+
+5. If /ashlr-doctor reports 0 failures, ask me:
+     "Doctor is clean. Want me to initialize a genome for this project
+      (/ashlr-genome-init) and then run the /ashlr-tour?"
+   Only run those two if I say yes. If I say no, stop here.
+
+Source: https://github.com/ashlrai/ashlr-plugin
+Landing: https://plugin.ashlr.ai/
+License: MIT · No account · Telemetry off by default; explicit opt-in only
+````
+
+---
+
+That's it. Claude Code runs the shell command, installs from the marketplace,
+reloads plugins or asks you for a full restart, self-diagnoses, and optionally
+bootstraps a genome + tour. If anything fails along the way, you'll see the
+exact error and can decide what to do next.
+
+## If you'd rather do it manually
+
+```bash
+# 1. terminal
+curl -fsSL https://plugin.ashlr.ai/install.sh | bash
+```
+
+Then inside Claude Code:
+
+```
+/plugin marketplace add ashlrai/ashlr-plugin
+/plugin install ashlr@ashlr-marketplace
+/reload-plugins
+/ashlr-doctor
+```
+
+If `/reload-plugins` is unavailable or `/ashlr-doctor` does not see the plugin,
+fully quit and restart Claude Code, then run `/ashlr-doctor` again.
+
+If doctor is clean:
+
+```
+/ashlr-genome-init
+/ashlr-tour
+```

package/docs/install-windows.md

@@ -0,0 +1,132 @@
+# Installing ashlr-plugin on Windows
+
+ashlr-plugin runs on Windows via [Bun for Windows](https://bun.sh/docs/installation#windows).
+All hooks are TypeScript files invoked with `bun run` — no bash or POSIX shell required.
+
+## Prerequisites
+
+1. **Bun for Windows** (1.x or later) — auto-installed by the marketplace flow the first time the MCP server starts. You don't need to install it up-front.
+
+   Manual install (only if you set `ASHLR_NO_AUTO_INSTALL=1` or want to pre-install):
+
+   ```powershell
+   powershell -c "irm bun.sh/install.ps1 | iex"
+   ```
+
+2. **Claude Code** — install the standard way from [claude.ai/claude-code](https://claude.ai/claude-code).
+
+3. **Git for Windows** — required for clone and git-related tools (`ashlr__diff`, commit attribution).
+   Download from [git-scm.com](https://git-scm.com/download/win).
+
+4. **ripgrep** (optional, improves `ashlr__grep` performance)
+
+   ```powershell
+   winget install BurntSushi.ripgrep.MSVC
+   ```
+
+### How bun auto-install works
+
+`plugin.json` spawns `node scripts/bootstrap.mjs`. The bootstrap checks for `bun`
+on PATH; if missing it runs `irm bun.sh/install.ps1 | iex` (Windows) or
+`curl -fsSL https://bun.sh/install | bash` (macOS/Linux), prepends the default
+bun install dir to the current process's PATH, and then execs `bun run` to
+start the real MCP entrypoint.
+
+Set `ASHLR_NO_AUTO_INSTALL=1` in your environment to disable this behaviour —
+the bootstrap will exit with a manual-install message instead.
+
+## Install
+
+Run the installer — it handles cloning, dependency install, and stale-cache cleanup:
+
+```powershell
+irm https://raw.githubusercontent.com/ashlrai/ashlr-plugin/main/docs/install.ps1 | iex
+```
+
+If Bun is not installed, the script will ask:
+
+```
+[ashlr] Bun is required but not found.
+[ashlr] Install Bun now? (Y/n)
+```
+
+Press Enter (or Y) to let the installer fetch and configure Bun automatically. If you
+decline, install Bun manually first and re-run.
+
+The installer clones to:
+
+```
+%USERPROFILE%\.claude\plugins\cache\ashlr-marketplace\ashlr\<version>\
+```
+
+This matches the path Claude Code's marketplace flow expects, so `/plugin install` is
+instant and re-runs update the active copy rather than creating orphan directories.
+
+After the script completes, run these two commands inside Claude Code:
+
+```
+/plugin marketplace add ashlrai/ashlr-plugin
+/plugin install ashlr@ashlr-marketplace
+/reload-plugins
+```
+
+Then run `/ashlr-status`. If `/reload-plugins` is unavailable or the status
+check does not see ashlr, fully quit and restart Claude Code.
+
+## Migration note
+
+If you previously installed with an older version of this script, you may have an orphan
+copy at `%USERPROFILE%\.claude\plugins\ashlr-plugin\`. It is safe to delete that directory
+manually — it is not referenced by Claude Code's marketplace flow.
+
+## Bun auto-install
+
+Both `install.ps1` (Windows) and `install.sh` (macOS/Linux) offer an interactive Bun
+install prompt when Bun is missing. On Windows:
+
+- The script runs `irm bun.sh/install.ps1 | iex` via an inner `powershell` call.
+- After install it refreshes `PATH` in the current session and re-checks.
+- If Bun still isn't on PATH (rare, requires a new shell), exit 1 with instructions.
+
+On macOS/Linux, `install.sh` only offers the prompt when stdin is a terminal (TTY). In
+non-interactive/piped mode it falls through to the original error message.
+
+## Shell behavior
+
+On Windows, `ashlr__bash` uses **PowerShell** (`pwsh` if available, otherwise `powershell`)
+instead of `/bin/sh`. This means:
+
+- Commands like `ls`, `cat`, `rm` use their PowerShell aliases, not POSIX tools.
+- If you need POSIX shell behavior, install [Git for Windows](https://git-scm.com) and
+  set `SHELL=C:\Program Files\Git\bin\bash.exe` in your environment.
+
+## Key file permissions (genome encryption)
+
+On POSIX systems, `~/.ashlr/team-keys/*.key` files are protected with `chmod 0600`.
+On Windows, NTFS does not support POSIX ACLs. ashlr-plugin logs a one-time warning
+and continues — the file is written but not restricted at the OS level.
+
+Recommended mitigations (choose one):
+
+- **BitLocker**: Encrypt the entire volume containing your user profile.
+- **Windows EFS**: Right-click `%USERPROFILE%\.ashlr\team-keys\` in Explorer,
+  Properties > Advanced > Encrypt contents.
+- **Dedicated protected directory**: Move key storage to a BitLocker-protected
+  secondary drive or VeraCrypt container.
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| `irm ... \| iex` blocked by execution policy | Run `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser` first, then re-run |
+| `bun: command not found` after auto-install | Open a new terminal — PATH updates require a new session |
+| `git: command not found` | Install [Git for Windows](https://git-scm.com/download/win) and ensure it's on PATH |
+| `rg: command not found` | Install via `winget install BurntSushi.ripgrep.MSVC` or skip (`ashlr__grep` falls back gracefully) |
+| Hook errors mentioning `bash` | Ensure hooks.json points at `.ts` files (not `.sh`). Run `bun run scripts/doctor.ts` |
+| Key file warning on every session | Expected on Windows — see "Key file permissions" above |
+
+## WSL (optional)
+
+If you prefer a full Linux environment, install ashlr-plugin inside
+[WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install) using `install.sh`.
+The TypeScript hooks work in WSL without any changes.

package/docs/install.ps1

@@ -0,0 +1,171 @@
+# install.ps1 — ashlr-plugin Windows installer
+#
+# Usage:
+#   irm https://raw.githubusercontent.com/ashlrai/ashlr-plugin/main/docs/install.ps1 | iex
+#
+# Or locally:
+#   .\docs\install.ps1
+#
+# Requirements: Bun for Windows, Git for Windows
+# Supports: Windows PowerShell 5.1+, PowerShell 7+
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$PluginRepo = "https://github.com/ashlrai/ashlr-plugin"
+
+# Target path mirrors the macOS/Linux marketplace cache structure:
+#   ~/.claude/plugins/cache/ashlr-marketplace/ashlr/<version>/
+# Version is resolved from package.json after clone; we use a temp dir first,
+# then move into the versioned slot.
+$CacheBase = Join-Path $env:USERPROFILE ".claude\plugins\cache\ashlr-marketplace\ashlr"
+
+function Write-Step([string]$msg) {
+    Write-Host "[ashlr] $msg" -ForegroundColor Cyan
+}
+
+function Write-Ok([string]$msg) {
+    Write-Host "[ashlr] $msg" -ForegroundColor Green
+}
+
+function Write-Warn([string]$msg) {
+    Write-Host "[ashlr] WARNING: $msg" -ForegroundColor Yellow
+}
+
+function Write-Fail([string]$msg) {
+    Write-Host "[ashlr] ERROR: $msg" -ForegroundColor Red
+    exit 1
+}
+
+# ---- Check prerequisites ----
+
+Write-Step "Checking prerequisites..."
+
+# Bun — offer auto-install if missing
+if (-not (Get-Command bun -ErrorAction SilentlyContinue)) {
+    Write-Host "[ashlr] Bun is required but not found." -ForegroundColor Yellow
+    $answer = Read-Host "[ashlr] Install Bun now? (Y/n)"
+    if ($answer -eq "" -or $answer -match "^[Yy]") {
+        Write-Step "Running Bun installer..."
+        try {
+            powershell -NoProfile -Command "irm bun.sh/install.ps1 | iex"
+        } catch {
+            Write-Fail "Bun installer failed: $_"
+        }
+        # Refresh PATH for the current session
+        $env:PATH = [System.Environment]::GetEnvironmentVariable("PATH", "User") + ";" + `
+                    [System.Environment]::GetEnvironmentVariable("PATH", "Machine")
+        if (-not (Get-Command bun -ErrorAction SilentlyContinue)) {
+            Write-Fail "Bun was installed but is not on PATH yet. Open a new terminal and re-run this script."
+        }
+        Write-Ok "Bun installed successfully."
+    } else {
+        Write-Fail "Bun is not installed. Install it with: powershell -c `"irm bun.sh/install.ps1 | iex`""
+    }
+}
+Write-Ok "Bun $(bun --version) found"
+
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    Write-Fail "Git is not installed. Download from https://git-scm.com/download/win"
+}
+Write-Ok "Git $(git --version) found"
+
+# ---- Ensure cache base exists ----
+
+if (-not (Test-Path $CacheBase)) {
+    New-Item -ItemType Directory -Path $CacheBase -Force | Out-Null
+}
+
+# ---- Clone to a stable 'current' working dir, then read version ----
+# We clone into a fixed 'current' subdirectory under CacheBase, read the
+# version from package.json, then move it to the versioned slot.
+
+$WorkDir = Join-Path $CacheBase "current"
+
+if (Test-Path (Join-Path $WorkDir ".git")) {
+    Write-Step "Found existing clone — updating..."
+    git -C $WorkDir fetch --quiet origin main
+    git -C $WorkDir reset --quiet --hard origin/main
+} else {
+    if (Test-Path $WorkDir) {
+        Remove-Item -Recurse -Force $WorkDir
+    }
+    Write-Step "Cloning plugin..."
+    git clone --quiet $PluginRepo $WorkDir
+}
+
+Write-Ok "Plugin source ready."
+
+# Read version from package.json
+$pkgJson = Get-Content (Join-Path $WorkDir "package.json") -Raw | ConvertFrom-Json
+$Version = $pkgJson.version
+if (-not $Version) {
+    Write-Warn "Could not read version from package.json; defaulting to 'latest'."
+    $Version = "latest"
+}
+
+# ---- Move/copy into versioned slot ----
+
+$VersionDir = Join-Path $CacheBase $Version
+
+if (Test-Path $VersionDir) {
+    # Already exists — remove and replace so update is idempotent
+    Remove-Item -Recurse -Force $VersionDir
+}
+
+Write-Step "Installing to $VersionDir ..."
+# Use robocopy for a reliable move on Windows 5.1 (Move-Item can fail across drives)
+$null = robocopy $WorkDir $VersionDir /E /NFL /NDL /NJH /NJS /NC /NS /NP
+Remove-Item -Recurse -Force $WorkDir
+
+$PluginDir = $VersionDir
+Write-Ok "Plugin at: $PluginDir"
+
+# ---- Prune stale sibling versioned directories ----
+# Keep only the newest semver dir; remove the rest.
+
+$semverPattern = '^\d+\.\d+\.\d+$'
+$siblingDirs = Get-ChildItem -Path $CacheBase -Directory |
+    Where-Object { $_.Name -match $semverPattern } |
+    Sort-Object { [Version]$_.Name }
+
+if ($siblingDirs.Count -gt 1) {
+    $latest = $siblingDirs[-1].Name
+    foreach ($dir in $siblingDirs) {
+        if ($dir.Name -ne $latest) {
+            Write-Warn "Removing stale cache version: $($dir.Name)"
+            Remove-Item -Recurse -Force $dir.FullName
+        }
+    }
+    Write-Ok "Kept only latest cache version: $latest"
+}
+
+# ---- Install dependencies ----
+
+Write-Step "Running bun install..."
+Push-Location $PluginDir
+try {
+    bun install --silent
+    Write-Ok "Dependencies installed."
+} finally {
+    Pop-Location
+}
+
+# ---- Next steps ----
+
+Write-Host ""
+Write-Ok "Installation complete."
+Write-Host ""
+Write-Host "Next steps — inside Claude Code:" -ForegroundColor White
+Write-Host ""
+Write-Host "  /plugin marketplace add ashlrai/ashlr-plugin" -ForegroundColor Gray
+Write-Host "  /plugin install ashlr@ashlr-marketplace" -ForegroundColor Gray
+Write-Host "  /reload-plugins" -ForegroundColor Gray
+Write-Host ""
+Write-Host "Then run /ashlr-status. If /reload-plugins is unavailable or the status check does not see ashlr, fully quit and restart Claude Code." -ForegroundColor White
+Write-Host ""
+Write-Ok "Start here:"
+Write-Host "  /ashlr-tour   -- 2-minute guided tour of every tool, hook, and command" -ForegroundColor Gray
+Write-Host ""
+Write-Host "Landing page: https://plugin.ashlr.ai/" -ForegroundColor Cyan
+Write-Host "Source:       https://github.com/ashlrai/ashlr-plugin" -ForegroundColor Cyan

package/docs/install.sh

@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+# ashlr-plugin Claude Code one-liner installer.
+#
+# Usage:
+#   curl -fsSL https://plugin.ashlr.ai/install.sh | bash
+#
+# What it does (idempotent — safe to re-run):
+#   1. Checks bun is installed (links to install if missing)
+#   2. Clones the plugin repo into Claude Code's marketplace cache
+#   3. Runs `bun install` so MCP servers have their deps
+#   4. Tells you the exact slash commands to run inside Claude Code
+#
+# Does NOT modify your Claude Code settings.json. Does NOT install globally.
+# Everything lives in ~/.claude/plugins/cache/.
+
+set -euo pipefail
+
+cyan()   { printf "\033[36m%s\033[0m\n" "$*"; }
+green()  { printf "\033[32m%s\033[0m\n" "$*"; }
+yellow() { printf "\033[33m%s\033[0m\n" "$*"; }
+red()    { printf "\033[31m%s\033[0m\n" "$*"; }
+
+cyan "ashlr-plugin Claude Code installer · github.com/ashlrai/ashlr-plugin"
+echo
+
+# 1. Prerequisite: bun
+if ! command -v bun >/dev/null 2>&1; then
+  yellow "⚠  bun is not installed."
+  # Offer auto-install when stdin is a terminal (skip in piped/non-interactive mode).
+  if [ -t 0 ]; then
+    printf "   Install Bun now via curl -fsSL bun.sh/install | bash? (Y/n) "
+    read -r _bun_answer </dev/tty
+    case "${_bun_answer:-Y}" in
+      [Yy]|"")
+        yellow "→ Running Bun installer..."
+        curl -fsSL https://bun.sh/install | bash
+        # Source the profile additions the Bun installer wrote.
+        for _rc in "$HOME/.bashrc" "$HOME/.zshrc" "$HOME/.profile"; do
+          # shellcheck disable=SC1090
+          [ -f "$_rc" ] && . "$_rc" 2>/dev/null || true
+        done
+        # Also update PATH directly for this shell session.
+        export PATH="$HOME/.bun/bin:$PATH"
+        if ! command -v bun >/dev/null 2>&1; then
+          red "✗ Bun was installed but is not on PATH yet."
+          echo "  Open a new terminal and re-run this script."
+          exit 1
+        fi
+        green "✓ Bun installed successfully."
+        ;;
+      *)
+        red "✗ bun is not installed."
+        echo "  Install it first: https://bun.sh  (curl -fsSL https://bun.sh/install | bash)"
+        echo "  ashlr-plugin's MCP servers run under bun."
+        exit 1
+        ;;
+    esac
+  else
+    yellow "⚠  bun is not installed — skipping cache pre-warm."
+    echo "  This installer will still finish cloning + printing next steps."
+    echo "  bun will be auto-installed when the MCP server starts for the first time."
+    echo "  (Set ASHLR_NO_AUTO_INSTALL=1 to opt out.)"
+    _skip_bun_install=1
+  fi
+fi
+if [ -z "${_skip_bun_install:-}" ]; then
+  green "✓ bun $(bun --version)"
+fi
+
+# 2. Prerequisite: git + gh or raw clone access
+if ! command -v git >/dev/null 2>&1; then
+  red "✗ git is not installed."
+  exit 1
+fi
+green "✓ git $(git --version | awk '{print $3}')"
+
+# 3. Pre-clone into Claude Code's cache dir so /plugin install is instant
+CACHE_DIR="$HOME/.claude/plugins/cache/ashlr-marketplace/ashlr"
+mkdir -p "$(dirname "$CACHE_DIR")"
+
+if [ -d "$CACHE_DIR/.git" ]; then
+  yellow "→ Cache exists — updating"
+  git -C "$CACHE_DIR" fetch --quiet origin main
+  git -C "$CACHE_DIR" reset --quiet --hard origin/main
+else
+  yellow "→ Cloning plugin to $CACHE_DIR"
+  git clone --quiet https://github.com/ashlrai/ashlr-plugin.git "$CACHE_DIR"
+fi
+green "✓ plugin at: $CACHE_DIR"
+
+# 3b. Prune stale sibling cache versions (keep only the latest semver dir).
+# Claude Code's marketplace cache sometimes accumulates old <X.Y.Z>/ dirs
+# next to the active one. Keep only the newest.
+SIBLING_PARENT="$(dirname "$CACHE_DIR")"
+if [ -d "$SIBLING_PARENT" ]; then
+  # Collect semver-shaped siblings, sort with -V, drop the latest, rm the rest.
+  # shellcheck disable=SC2012
+  mapfile -t _semver_dirs < <(
+    ls -1 "$SIBLING_PARENT" 2>/dev/null \
+      | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' \
+      | sort -V || true
+  ) || _semver_dirs=()
+  if [ "${#_semver_dirs[@]}" -gt 1 ]; then
+    _latest="${_semver_dirs[-1]}"
+    for _v in "${_semver_dirs[@]}"; do
+      if [ "$_v" != "$_latest" ]; then
+        yellow "→ Removing stale cache version: $_v"
+        rm -rf "${SIBLING_PARENT:?}/${_v}"
+      fi
+    done
+    green "✓ kept only latest cache version: $_latest"
+  fi
+fi
+
+# 4. Install dependencies (skipped when bun isn't present — the MCP bootstrap
+# will auto-install bun + run `bun install` itself on first spawn).
+if [ -z "${_skip_bun_install:-}" ]; then
+  yellow "→ Installing dependencies (bun install)"
+  (cd "$CACHE_DIR" && bun install --silent 2>&1 | tail -5 || true)
+  green "✓ dependencies installed"
+else
+  yellow "→ Skipping bun install — will run on first MCP server spawn"
+fi
+
+echo
+cyan "Done. Next steps — inside Claude Code:"
+echo
+echo "  /plugin marketplace add ashlrai/ashlr-plugin"
+echo "  /plugin install ashlr@ashlr-marketplace"
+echo "  /reload-plugins"
+echo
+echo "Then run /ashlr-status. If /reload-plugins is unavailable or the"
+echo "status check does not see ashlr, fully quit and restart Claude Code."
+echo
+green "▶ Start here:"
+echo "  /ashlr-tour   — 2-minute guided tour of every tool, hook, and command"
+echo
+cyan "Codex users:"
+echo "  git clone https://github.com/ashlrai/ashlr-plugin"
+echo "  cd ashlr-plugin && bun install"
+echo "  codex plugin marketplace add ashlrai/ashlr-plugin"
+echo "  codex plugin add ashlr@ashlr-marketplace"
+echo "  bun run scripts/cli.ts codex-doctor --json"
+echo
+cyan "Landing page: https://plugin.ashlr.ai/"
+cyan "Source:       https://github.com/ashlrai/ashlr-plugin"

package/docs/launch/README.md

@@ -0,0 +1,114 @@
+# Launch playbook — ashlr-plugin v1.36 Codex-native release
+
+A meta-guide for Mason (first-time launcher) covering where each post goes, when to post, what to monitor, and how to answer the questions that will show up in the first 24 hours. If you're reading this and you're not Mason: the tone is internal-note, not polished copy.
+
+---
+
+## When to post what
+
+| Platform | File | Best window (PT) | Why |
+|---|---|---|---|
+| Hacker News | `hn.md` | **Tue–Thu, 7:30–9:30am PT** | HN front-page algo favors morning US-east activity. Avoid Monday (noisy), Friday (dead), weekends (low-signal). |
+| X / Twitter | `x.md` | **Weekday evenings, 6–9pm PT** | Dev-twitter is an after-work crowd. Thread, not single tweet. Pin it. |
+| r/ClaudeAI | `reddit.md` (variant 1) | Any weekday, **avoid weekends** | Reddit's Claude subs are active all day; Sat/Sun posts get buried by meme content. |
+| r/ClaudeCode | `reddit.md` (variant 2) | Same | Smaller sub, more technical — quality threshold is higher. |
+
+**Order of operations:** Post HN first (highest risk, highest reward). If HN picks up, tweet the HN link. Post Reddit after HN peaks (either way — a dead HN post is still a fine Reddit post, and a live one gives Reddit posts a "here's the discussion" link to include).
+
+**Don't cross-post the HN text verbatim to Reddit.** Reddit mods smell it. Variants in `reddit.md` are pre-tailored.
+
+**Don't submit the same URL to HN twice** in a short window — it'll get flagged. If the first HN submission flops, wait a week and try a different title.
+
+---
+
+## Monitoring checklist (first 24h)
+
+Refresh roughly every 30 min for the first 3 hours, then hourly until bedtime.
+
+- **GitHub stars** — `gh api repos/ashlrai/ashlr-plugin | jq .stargazers_count`. Expect 0–50 for a quiet launch, 50–500 for a good HN run.
+- **Issues opened** — `gh issue list --repo ashlrai/ashlr-plugin`. Respond within 2h if you're awake. A fast first response shapes the whole thread.
+- **HN comments** — refresh the submission, read every comment before replying. HN rewards thoughtful, don't rush.
+- **X replies/quote-tweets** — quote-tweets matter more than replies for reach. Thank thoughtful ones, don't dunk on dumb ones.
+- **Reddit comments** — Reddit auto-sorts by controversial early; skim, respond to top-level questions only.
+- **Traffic** — if Pages analytics is wired, watch `plugin.ashlr.ai` referrers. Otherwise `gh api repos/.../traffic/views` (14-day window, updates hourly).
+- **`/ashlr-doctor` error reports** — if someone files an install issue, ask them to paste `/ashlr-doctor` output. Saves 10 back-and-forths.
+
+---
+
+## Rehearsed answers — the 10 questions you'll definitely get
+
+Keep these in a scratchpad. Don't copy-paste verbatim; rephrase slightly per thread so it doesn't feel templated.
+
+**Q: "Why not just make this a paid product?"**
+I wanted the mechanism auditable. WOZCODE exists, it's polished, people happily pay — I'm not trying to eat their lunch. This is for the people who want to see every line of code that's rewriting their MCP traffic.
+
+**Q: "Does this work with Opus?"**
+Yes. Savings math is model-agnostic (characters in, tokens out); pricing math respects `ASHLR_PRICING_MODEL` so the `$` in `/ashlr-savings` reflects whatever plan you're on. Opus users see the biggest dollar savings because Opus is the most expensive per-token.
+
+**Q: "Is it spying on me / phoning home?"**
+No. `git grep -E 'posthog|fetch.*\.(com|io)|analytics'` on the repo — nothing outbound. The one exception is `/ashlr-doctor`, which hits GitHub's public releases API to check if you're behind. That's a deliberate user-invoked action, not background.
+
+**Q: "How does this compare to WOZCODE?"**
+Same shape: tri-agent, Read/Grep/Edit redirect, commit attribution, edit-batching, status line. Mine adds SQL + Bash + Tree MCP tools and a baseline scanner. Mine is MIT, no account, telemetry off by default. Theirs is more polished and has a real support channel. Both valid.
+
+**Q: "Does the tokenizer count match Anthropic exactly?"**
+No — Anthropic doesn't publish theirs. I use tiktoken cl100k_base as a proxy, which is ~12.9% more accurate than chars/4 on code (measured). I'd rather ship an honest proxy than a fake-precise estimate.
+
+**Q: "Will it work with Cursor / Zed / Windsurf?"**
+Cursor, Zed, and Windsurf can use Ashlr through MCP-only config. Codex also has plugin-format install via `codex plugin marketplace add ashlrai/ashlr-plugin` and `codex plugin add ashlr@ashlr-marketplace`. Claude-Code-only surfaces are slash commands, status line, OAuth bootstrap, and redirect-mode hooks.
+
+**Q: "Why Bun? I don't have Bun."**
+Bun starts MCP servers faster than Node and the install story is cleaner. `curl -fsSL https://bun.sh/install | bash` — 5 seconds. If this is a hard blocker for someone, open an issue; Node compat is a reasonable ask but not free to maintain.
+
+**Q: "Show me the real savings on my own code."**
+`/ashlr-benchmark` runs the harness against the current working directory. Real files, real numbers, reproducible.
+
+**Q: "Is the -57% figure cherry-picked?"**
+It's the mean across files ≥ 2 KB in the benchmark corpus. Smaller files see 0% because `snipCompact` has a 2 KB threshold — I could have dropped the threshold to juice the number, I didn't.
+
+**Q: "What's the genome thing?"**
+`.ashlrcode/genome/` is a sectioned project spec (markdown files, ~one per concern). `ashlr__grep` returns only the task-relevant sections instead of grepping the whole tree. Ashlr includes a scribe that keeps the genome current as you work. Run `/ashlr-genome-init` to try it.
+
+---
+
+## What to NOT do
+
+These matter more than the positive advice above. Re-read before posting.
+
+1. **Don't engage trolls.** Every launch thread gets one "this is garbage / reinventing the wheel / you should just use X" comment. Do not reply. Replying legitimizes it and sinks the thread. Move on.
+2. **Don't overpromise.** The numbers are specific: −57% cross-repo. Don't let excitement turn it into "80% faster" or "80% cheaper" — those mean different things.
+3. **Don't vanity-name-drop.** No "I used this at $BIG_CO" if you didn't. No "endorsed by X" unless X actually endorsed it. Credibility is cheap to lose.
+4. **Don't shit on WOZCODE.** They built the pattern first. Frame as "open-source equivalent," never "killer" or "replacement." You'll get WOZCODE users trying it precisely because you were respectful.
+5. **Don't amend the HN post after it's live.** Comments will reference earlier phrasing. If you find a typo, note it in a comment on your own thread instead.
+6. **Don't reply to every comment.** Reply to substantive questions, thoughtful critiques, and install issues. Skip "nice!" and "cool project" — a like is fine.
+7. **Don't cross-link your own Reddit post from X within the first hour.** Looks like brigading. Wait until it has organic traction.
+8. **Don't add an "upvote please" anywhere.** Instant credibility death on HN/Reddit.
+9. **Don't argue about the benchmark methodology in public.** If someone says the benchmark is bad, ask them to file an issue with a proposed improvement. Takes the heat off the thread and usually produces better data.
+10. **Don't launch on a day you can't monitor for 12 hours.** If you post and disappear, questions go unanswered and the thread dies.
+
+---
+
+## Sample reply templates
+
+Adapt, don't paste verbatim.
+
+**Install issue:**
+> Can you paste the output of `/ashlr-doctor`? That'll tell me whether it's an MCP registration issue, a bun version thing, or a plugin-path problem. If doctor itself fails, `bun --version` + `ls ~/.claude/plugins/cache/ashlr-marketplace/ashlr` is the next step.
+
+**Skeptical about numbers:**
+> Fair question. `/ashlr-benchmark` runs the harness on your working directory and prints the raw per-file savings. If it comes out very different from the −57% figure, I'd genuinely like the dataset — open an issue.
+
+**"Why should I trust you?"**
+> You shouldn't, really — that's the whole point of MIT + telemetry off by default. Source is 100% readable, stats never leave your disk unless you explicitly enable opt-in telemetry. If you find anything that contradicts that, it's a CVE and I want to know.
+
+**"Doesn't WOZCODE already do this?"**
+> Yes, and they did it first. Ashlr is the open-source equivalent — same shape, auditable source, no account, telemetry off by default. If WOZCODE's polish is worth $20/week to you, use WOZCODE. This is for people who want to read every line.
+
+---
+
+## After the launch
+
+- Merge any install-issue PRs within 48h if they're clean.
+- Write a "lessons learned" note in `docs/launch/post-mortem.md` once the dust settles — which number surprised you, which question you weren't ready for, what you'd change.
+- If traction is real, ask two or three early users for a short quote — not testimonials, just "what surprised you." Use in future posts.
+- Don't re-launch for at least 3 months. New major version = new launch; point release = don't.